PHP posix_getrlimit 读取进程软限制与硬限制的方法

在 PHP CLI、队列消费者或常驻服务里，想知道进程还能打开多少文件、允许使用多少 CPU 时间，先看 posix_getrlimit()。它读取当前进程的资源限制，返回每类资源的 soft（内核当前执行的软限制）和 hard（软限制可以提升到的上限）信息；它本身不修改限制。

官方地址：https://www.php.net/manual/en/function.posix-getrlimit.php

posix_getrlimit 读取的到底是什么

资源限制属于进程视角，而不是 PHP 配置数组。当前进程启动时继承了父进程的限制，CLI、PHP-FPM、容器入口和队列 worker 看到的值可能不同。PHP 手册把每项限制分成 soft 与 hard：soft 是内核实际执行的门槛，hard 是 soft 能提升到的天花板。读取时先把它们当成诊断信息，不要据此推断修改一定会成功。

无参数调用得到一个关联数组，键通常带有 soft 或 hard 前缀，例如 soft openfiles 与 hard openfiles。值可能是整数，也可能是 unlimited 字符串，显示层不要强制做整数转换。

无参数读取全部限制并保留类型

全量读取适合启动诊断、健康检查和问题报告。下面的示例把结果按资源名重新归组，只做展示，不把 unlimited 转成数值，也不假定所有系统都会返回同样的资源键。

 $value) {
    // 手册返回的键通常是“soft openfiles”或“hard openfiles”。
    [$level, $resource] = array_pad(explode(' ', $label, 2), 2, '');
    $grouped[$resource][$level] = $value; // 值可能是整数，也可能是 unlimited。
}

foreach ($grouped as $resource => $values) {
    printf("%s: soft=%s, hard=%s\n", $resource,
        $values['soft'] ?? '未提供', $values['hard'] ?? '未提供');
}
?>

这里的 ?? 不是多余的：不同系统、不同 POSIX 实现可能缺少某个资源键。诊断程序应记录“未提供”，而不是用零代替，否则会把未知状态伪装成严格限制。

按资源读取时怎样缩小结果范围

PHP 8.3 起，posix_getrlimit() 支持可选的资源参数。只关心打开文件数时，可以传入对应的 POSIX_RLIMIT_* 常量；返回结果仍是包含 soft/hard 信息的关联数组。这样做适合把单项限制写入启动日志或指标标签，但要先判断常量是否在当前扩展和平台中定义。

 $value) {
    // 仍按返回键识别 soft/hard，不假设数组下标是 0 和 1。
    printf("%s=%s\n", $label, is_string($value) ? $value : (string) $value);
}
?>

资源常量的可用性和具体含义受操作系统与扩展版本影响。即使能读到某项，也不代表应用有权限提升 hard，修改限制应由进程启动器、容器运行时或系统管理员负责。

四个容易误判的边界

在容器里还要注意观察对象：宿主机 shell 的 ulimit、PHP-FPM master 进程和 worker 进程不是同一个观察点。把同一份诊断脚本放到真实启动链路中执行，结论才对应实际服务。

常见问题

posix_getrlimit 会修改当前进程限制吗？

不会。它只读取限制；需要调整时应使用合适的系统启动配置或专门的权限边界，不能把读取函数当成 setter。

为什么 soft 和 hard 都可能显示 unlimited？

这表示该资源没有返回有限数值上限。它不是 PHP 整数，也不应被转换成某个“足够大”的伪数值。

为什么本地 CLI 与线上 PHP-FPM 的结果不同？

二者可能由不同父进程、服务账号、容器限制和启动参数产生。应在实际 worker 进程中读取，而不是只比较开发机结果。

把 posix_getrlimit() 当作进程边界探针即可：先确认读取对象，再区分 soft、hard、unlimited、缺键和 false。这样记录出的资源限制，才足以支持文件句柄、CPU 时间或进程数量问题的后续排查。