使用cli_get_process_title却拿不到进程标题？检查PHP是否启用了相关扩展

在使用 PHP 编写命令行脚本时，有时候我们希望通过 cli_set_process_title 和 cli_get_process_title 来设置或获取进程标题，以便更清晰地标识当前运行的脚本状态，尤其在使用 ps、top 等工具进行进程监控时。这在编写守护进程、任务队列消费者等 CLI 应用中非常实用。

然而，许多开发者在调用 cli_get_process_title() 时会遇到返回空字符串或者 false 的问题。明明前面已经调用过 cli_set_process_title() 成功设置了标题，为什么再获取却失败呢？问题可能并不在你的代码，而是在 PHP 的构建方式。

问题核心：扩展未启用

PHP 的 cli_set_process_title 和 cli_get_process_title 函数来自于 proctitle 支持，这是 PHP 在编译时可选的一项功能。如果你的 PHP 没有启用 --enable-cli 且在构建过程中没有启用 --enable-proctitle，那么这些函数就形同虚设。

如何确认是否启用了 proctitle 支持？

你可以使用以下命令检查：

php -i | grep "Process title"

如果没有相关输出，或者你发现以下行缺失：

Process title support => enabled

那就说明你的 PHP 环境没有启用这个特性。

示例代码

以下是一个设置并尝试获取进程标题的例子：

<?php
cli_set_process_title("my_worker_task");
$title = cli_get_process_title();

if ($title === false || $title === "") {
    echo "无法获取进程标题，请检查 PHP 是否启用了 proctitle 支持。\n";
} else {
    echo "当前进程标题是: " . $title . "\n";
}

如果你的 PHP 没有启用相关支持，执行后你可能只会看到警告或空输出。

解决方案

1. 重新编译 PHP（推荐在服务器部署环境中）

你需要在编译 PHP 时加入 --enable-cli（通常默认启用）和 --enable-proctitle 选项。例如：

./configure --enable-cli --enable-proctitle
make && make install

这会启用进程标题支持，之后你就可以正常使用这两个函数了。

2. 使用替代方式（Linux 系统）

如果你无法重新编译 PHP，可以考虑通过 exec() 或调用系统命令手动设置进程标题，例如：

<?php
$title = "my_custom_task";
exec("exec -a $title php your_script.php");

不过需要注意的是，这种方式不够优雅，也可能因为 exec() 被禁用或不同系统行为不同而不可靠。

小结

cli_get_process_title() 拿不到进程标题，很可能不是代码的问题，而是 PHP 没有启用相关功能支持。开发者在遇到此类问题时，第一时间应检查当前 PHP 环境的构建参数。特别是在使用 Docker 或某些操作系统自带 PHP 版本时，更应该留意这个细节。