在现代 Web 应用开发中，PHP 早已不再局限于简单的页面渲染。随着异步处理、微服务架构的兴起，我们经常需要让 PHP 脚本作为守护进程（daemon）在后台持续运行，例如 Laravel Queue 的 Worker、定时任务处理脚本，或是自定义的长连接服务。
然而，这些后台进程的稳定运行却是一个不小的挑战。它们可能因为内存溢出、代码错误、网络波动等原因意外终止。一旦进程中断，如果没有及时发现并重启，就会导致业务功能受损，用户体验下降。传统的解决方案通常是依赖系统级的 cron 定时检查，或者编写复杂的 shell 脚本来监控和重启，但这既不灵活，也难以与 php 应用程序的业务逻辑深度整合。
为了解决这个问题，许多开发者会选择使用 Supervisor，一个用 Python 编写的进程控制系统。Supervisor 能够监控并自动重启崩溃的进程，极大地提高了后台服务的健壮性。但新的问题又来了：我们如何在 PHP 应用程序内部，通过代码来启动、停止、检查这些由 Supervisor 管理的进程呢？难道每次都要 SSH 到服务器上敲命令吗？
这时，supervisorphp/supervisor 库就如同及时雨般出现了。
supervisorphp/supervisor：PHP 与 Supervisor 的桥梁
supervisorphp/supervisor 是一个强大的 PHP 库，它允许你通过 Supervisor 的 XML-RPC API，直接在 PHP 代码中管理 Supervisor 监控的进程。这意味着你可以构建一个后台管理界面，或者集成到你的自动化部署流程中，实现对后台任务的完全编程控制。
立即学习“PHP免费学习笔记（深入）”；
它的核心优势在于：
- 程序化控制：无需手动登录服务器，直接在 PHP 应用中启动、停止、重启进程。
- 状态监控：实时获取进程状态、运行信息，方便进行健康检查和报警。
- 异常处理：提供了丰富的异常类，可以优雅地捕获和处理 Supervisor 返回的各种错误。
-
高度可扩展：基于
fXmlRpc库，支持多种 HTTP 客户端，如 Guzzle，方便集成到现有项目中。
如何使用 Composer 引入并管理 Supervisor 进程
首先，你需要通过 Composer 安装 supervisorphp/supervisor 库：
composer require supervisorphp/supervisor
由于 supervisorphp/supervisor 依赖 fXmlRpc 库进行 XML-RPC 通信，而 fXmlRpc 又需要一个 HTTP 客户端。这里我们推荐使用功能强大且广泛应用的 Guzzle HTTP 客户端。如果你还没有安装 Guzzle，也一并安装它：
composer require guzzlehttp/guzzle:^7.0
接下来，我们就可以在 PHP 代码中与 Supervisor 进行交互了。
['user', '123'], // 替换为你的 Supervisor 用户名和密码
// 如果通过 Unix Domain Socket 连接，可以这样配置：
// 'curl' => [
// CURLOPT_UNIX_SOCKET_PATH => '/var/run/supervisor.sock', // 替换为你的 socket 路径
// ],
]);
// 2. 创建 fXmlRpc 客户端
// fXmlRpc 客户端需要一个 PSR-7 HttpFactory 和一个 PSR-18 HTTP 客户端
$xmlRpcClient = new XmlRpcClient(
$supervisorUrl,
new PsrTransport(
new HttpFactory(), // PSR-7 HttpFactory 实现
$guzzleClient
)
);
// 3. 实例化 Supervisor 对象
$supervisor = new Supervisor($xmlRpcClient);
// 示例操作：
// 获取所有进程信息
echo "--- 所有进程信息 ---\n";
$allProcesses = $supervisor->getAllProcessInfo();
foreach ($allProcesses as $processInfo) {
echo "进程名称: {$processInfo['name']}, 状态: {$processInfo['statename']}\n";
}
// 假设我们有一个名为 'my_php_worker' 的进程
$processName = 'my_php_worker';
// 检查特定进程是否正在运行
if ($supervisor->getProcessInfo($processName)['state'] === Supervisor::RUNNING) {
echo "\n进程 '{$processName}' 正在运行。\n";
// 尝试停止进程
echo "尝试停止进程 '{$processName}'...\n";
$supervisor->stopProcess($processName);
echo "进程 '{$processName}' 已停止。\n";
} else {
echo "\n进程 '{$processName}' 未运行。\n";
}
// 再次检查状态
echo "停止后，进程 '{$processName}' 的状态: {$supervisor->getProcessInfo($processName)['statename']}\n";
// 启动进程
echo "尝试启动进程 '{$processName}'...\n";
// 第二个参数为 false 表示不等待进程启动完成，立即返回
$supervisor->startProcess($processName, false);
echo "进程 '{$processName}' 已启动（或正在启动中）。\n";
// 获取进程对象并进行操作
$process = $supervisor->getProcess($processName);
if ($process->isRunning()) {
echo "通过进程对象确认，'{$processName}' 正在运行。\n";
}
} catch (BadNameException $e) {
echo "错误：进程名称 '{$processName}' 不存在或不正确。\n";
} catch (SupervisorException $e) {
echo "Supervisor 错误：{$e->getMessage()}\n";
} catch (\Exception $e) {
echo "未知错误：{$e->getMessage()}\n";
}
// 注意：如果你使用了 PHP 的 XML-RPC 扩展（通常标记为 EXPERIMENTAL），
// 并且在处理进程日志时遇到问题，可能需要清理日志消息，因为该扩展有时对非标准 XML-RPC 响应不兼容。
// 通常情况下，使用 fXmlRpc 配合 Guzzle 这种方式不会有此问题。代码解释：
-
Guzzle 客户端：我们首先创建了一个 Guzzle
Client实例。如果你的 Supervisor 实例配置了用户名和密码，需要通过'auth'选项传递。如果通过 Unix Domain Socket 连接，则使用'curl'选项。 -
fXmlRpc 客户端：
supervisorphp/supervisor内部依赖fXmlRpc库进行 XML-RPC 通信。这里我们使用PsrTransport将 Guzzle 客户端作为底层 HTTP 传输层。HttpFactory实现了 PSR-17HttpFactoryInterface，用于创建 PSR-7 兼容的请求和响应对象。 -
Supervisor 对象：将配置好的
fXmlRpc客户端传递给Supervisor\Supervisor的构造函数，即可获得一个可以与 Supervisor 守护进程通信的对象。 -
进程操作：
-
getAllProcessInfo()：获取所有受 Supervisor 监控的进程的详细信息数组。 -
getProcessInfo($name)：获取指定名称进程的详细信息。 -
stopProcess($name)：停止指定名称的进程。 -
startProcess($name, $wait)：启动指定名称的进程。第二个参数$wait为true时，会等待进程启动成功才返回；为false则立即返回。 -
getProcess($name)：获取一个Process对象，你可以通过该对象调用isRunning()、getPayload()等方法。
-
-
异常处理：
supervisorphp/supervisor为 Supervisor 可能返回的各种错误定义了具体的异常类（如BadNameException），它们都继承自SupervisorException。这使得你可以精确地捕获并处理不同类型的错误，增强了程序的健壮性。
总结与实际应用效果
通过 supervisorphp/supervisor，我们成功地将 Supervisor 的强大功能集成到了 PHP 应用程序中。这带来了多方面的显著优势：
- 自动化与效率提升：告别手动操作，你可以编写脚本自动检测并重启异常进程，或者在部署流程中自动启动所有后台服务。
- 集中管理：在你的管理后台（例如 Laravel Nova 或自定义的后台系统）中，可以直接展示所有后台任务的状态，并提供一键启动/停止/重启的功能，极大地提升了运维效率。
- 更强的容错性：结合业务逻辑，你可以根据特定条件（例如队列积压过多）触发进程重启，确保业务的连续性。
- 开发体验优化：开发者无需深入了解 Supervisor 的命令行工具，只需使用熟悉的 PHP 代码即可完成所有操作。
总之，supervisorphp/supervisor 库为 PHP 开发者提供了一个优雅、高效的方式来管理后台进程。它不仅解决了手动重启的痛点，更将进程管理提升到了一个程序化、自动化的新高度，让你的 PHP 应用在处理复杂后台任务时更加稳定和可靠。现在，就动手尝试一下，让你的 PHP 应用告别手动重启的烦恼吧！
