判断是否在 Docker 中运行的另类用法（结合 php_uname()）

M66 2025-06-02

在开发和部署 PHP 应用程序时，了解你的 PHP 环境是否运行在 Docker 容器中可以帮助你做出针对性的优化和调整。通常，容器化环境会提供一种隔离的运行环境，因此在一些情况下，我们需要检测 PHP 是否在 Docker 容器中运行。

本文将介绍如何通过 PHP 的 php_uname() 函数来判断你的 PHP 是否在 Docker 容器中运行。

1. 什么是 php_uname() 函数？

php_uname() 是 PHP 的一个内置函数，主要用于返回系统的信息，类似于 Unix 系统中的 uname 命令。它会返回当前系统的操作系统名称、主机名、版本等信息。

函数的基本用法如下：

php_uname();

这将返回类似如下的字符串（视具体操作系统而定）：

Linux myhostname 4.15.0-45-generic #48-Ubuntu SMP Thu Jan 17 16:24:23 UTC 2019 x86_64

该字符串包含了操作系统类型、主机名、内核版本等信息。

2. 如何判断 PHP 是否运行在 Docker 容器中？

Docker 容器通常使用特定的内核版本，并且容器中的 /proc/1/cgroup 文件会包含一些与 Docker 相关的信息。因此，使用 php_uname() 直接判断 PHP 是否在 Docker 中并不容易。但我们可以通过结合系统文件来判断。

步骤：

查看 php_uname() 输出

首先，使用 php_uname() 输出操作系统的信息：

echo php_uname();

你将得到类似以下的输出：

Linux myhostname 5.4.0-100-generic #113-Ubuntu SMP Wed Nov 25 13:02:28 UTC 2020 x86_64

这并不能直接告诉我们 PHP 是否在 Docker 中运行。为了进一步验证，我们需要检查 Docker 容器的特征。

结合 /proc/1/cgroup 文件

Docker 容器的文件系统通常包含 /proc/1/cgroup 文件，并且在该文件中我们能找到与 Docker 容器相关的信息。通过检测该文件内容，我们可以推断出是否运行在 Docker 环境中。

可以使用以下代码来检查：

function isRunningInDocker() {
    // 查看是否存在 /proc/1/cgroup 文件
    if (is_readable('/proc/1/cgroup')) {
        $cgroup = file_get_contents('/proc/1/cgroup');
        
        // 判断是否包含 docker 的标识
        if (strpos($cgroup, 'docker') !== false) {
            return true; // 运行在 Docker 中
        }
    }
    return false; // 未运行在 Docker 中
}

if (isRunningInDocker()) {
    echo "PHP 正在 Docker 容器中运行！";
} else {
    echo "PHP 没有运行在 Docker 容器中。";
}

解释：

该代码会检查 /proc/1/cgroup 文件并查找是否有 docker 相关的标记。
如果该文件中包含了 Docker 的标识字符串，则可以确定 PHP 是在 Docker 容器中运行。

3. 完整代码示例

<?php

// 使用 php_uname() 获取操作系统信息
echo '操作系统信息: ' . php_uname() . "\n";

// 检查是否在 Docker 容器中运行
function isRunningInDocker() {
    if (is_readable('/proc/1/cgroup')) {
        $cgroup = file_get_contents('/proc/1/cgroup');
        if (strpos($cgroup, 'docker') !== false) {
            return true; // 是 Docker 环境
        }
    }
    return false; // 不是 Docker 环境
}

if (isRunningInDocker()) {
    echo "PHP 正在 Docker 容器中运行！";
} else {
    echo "PHP 没有运行在 Docker 容器中。";
}
?>

4. 结论

通过以上方法，你可以利用 php_uname() 获取操作系统信息，并结合检查 /proc/1/cgroup 文件中的 Docker 相关标记来判断 PHP 是否运行在 Docker 容器中。这是一个简洁且有效的方法，可以帮助你在容器化环境中执行特定操作或调整。

希望这篇文章对你有所帮助！如果有更多问题，欢迎访问我们网站。

php_uname