在现代 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 进行交互了。
<?php require 'vendor/autoload.php'; // 引入 Composer 自动加载 use GuzzleHttpClient; use GuzzleHttpPsr7HttpFactory; use fXmlRpcClient as XmlRpcClient; use fXmlRpcTransportPsrTransport; use SupervisorSupervisor; use SupervisorExceptionFaultBadNameException; use SupervisorExceptionSupervisorException; // 假设你的 Supervisor XML-RPC 接口运行在 127.0.0.1:9001 // 并且配置了用户名为 'user'，密码为 '123' $supervisorUrl = 'http://127.0.0.1:9001/RPC2'; try { // 1. 创建 Guzzle HTTP 客户端 // 如果 Supervisor 配置了认证，可以在这里传入用户名和密码 $guzzleClient = new Client([ 'auth' => ['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-17 HttpFactoryInterface，用于创建 PSR-7 兼容的请求和响应对象。
- Supervisor 对象：将配置好的 fXmlRpc 客户端传递给 SupervisorSupervisor 的构造函数，即可获得一个可以与 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 应用告别手动重启的烦恼吧！
