在 PHP 开发中，调用外部系统命令是一项核心任务。Symfony 的 Process 组件通过封装底层的 proc_open 逻辑，为开发者提供了一套优雅的 API 来管理子进程。理解子进程的"退出状态码（Exit Code）"是确保程序健壮性的关键，它直接反映了外部命令的执行结果。

进程退出码的基础逻辑

退出码是进程结束时返回给操作系统的一个整数，作为其运行状态的总结。在类 Unix 系统中，遵循一套通用的标准约定：

• 0：操作成功完成。
• 1-125：通用的错误范围，通常由应用程序自定义。
• 126：命令不可执行（权限问题或文件不是可执行脚本）。
• 127：找不到指定的命令。
• 128 + N：进程因收到信号 N 而终止。例如，退出码 137 表示进程因收到信号 9（SIGKILL）被强制关闭（128 + 9 = 137）。

使用 Symfony Process 捕获执行结果

Symfony\Component\Process\Process 类提供了多种方法来检索这些状态。以下是一个通过重构后的逻辑演示如何处理不同的执行结果：

use Symfony\Component\Process\Process;
use Symfony\Component\Process\Exception\ProcessTimedOutException;

$executor = new Process(['ls', '-alh', '/var/log']);
$executor->setTimeout(10);

try {
    $executor->run();

    if ($executor->isSuccessful()) {
        // 逻辑 A：处理成功输出
        echo "命令输出：\n" . $executor->getOutput();
    } else {
        // 逻辑 B：处理非零退出码
        $statusCode = $executor->getExitCode();
        $statusText = $executor->getExitCodeText();
        
        fprintf(STDERR, "错误发生。状态码: %d, 描述: %s\n", $statusCode, $statusText);
        
        if ($statusCode > 128) {
            $signalNumber = $statusCode - 128;
            echo "进程因信号 {$signalNumber} 终止。\n";
        }
    }
} catch (ProcessTimedOutException $e) {
    echo "进程运行超时：" . $e->getMessage();
}

深度解析状态判断方法

在实际开发中，开发者应优先使用 isSuccessful() 方法，因为它内部已经包含了对 0 值的校验逻辑。如果你需要更细粒度的控制，可以参考以下分类：

1. 状态文本转换

getExitCodeText() 是一个极具实用性的方法。它会根据退出码返回人类可读的字符串。例如，当退出码为 0 时返回 "OK"，当遇到系统定义的错误时，它能快速定位是信号干扰还是权限缺失。

2. 处理用户自定义错误

许多 CLI 工具（如 Git 或 Docker）会使用 64 到 113 之间的特定错误码来指示逻辑错误。你可以根据业务需求编写分支语句：

$exitCode = $jobRunner->getExitCode();

switch ($exitCode) {
    case 64: // 典型的命令行用法错误
        handleUsageError();
        break;
    case 127:
        logError("外部依赖未安装");
        break;
    default:
        logGeneralFailure($exitCode);
}

跨平台兼容性挑战

需要注意的是，Windows 操作系统并不完全遵循 POSIX 标准的退出码。在 Windows 环境下，getExitCodeText() 可能无法准确还原信号终止的描述，因为 Windows 的进程模型与 Unix 的信号量机制存在差异。在编写跨平台脚本时，建议尽量依赖特定的退出码数值而非系统信号偏移量。

开发最佳实践

• 启用超时控制：永远不要运行没有超时限制的外部进程，防止子进程僵死导致父进程资源耗尽。
• 实时流式输出：对于耗时较长的任务，不应等待 run() 结束，而应在构造时传入闭包，实时获取 STDOUT 和 STDERR。
• 错误隔离：通过检查 getErrorOutput() 来区分业务逻辑输出和错误诊断信息。