PHP Symfony Process怎样使用参数数组启动子进程

PHP 使用 Symfony Process 启动子进程时，最稳妥的写法是把命令拆成数组：第一个元素是可执行文件，后面的每个元素各自代表一个选项或参数。不要先把参数拼成一整行字符串再交给 Process，尤其不要把用户输入直接拼进 shell 命令。

官方文档：https://symfony.com/doc/current/components/process.html

参数数组的核心规则是“一个 argv 参数对应一个数组元素”。带空格的值仍然只占一个元素；需要 shell 重定向、管道或条件连接时，才考虑 fromShellCommandline()，并重新承担 shell 语法和转义责任。

最小写法：可执行文件和参数逐项放入数组

Symfony Process 的构造方法接收命令数组。下面的例子让 PHP 子进程执行一个脚本，并把姓名、重试次数作为两个独立选项传入。Alice Chen 虽然包含空格，但它仍然是一个参数元素，不需要手动调用 escapeshellarg()。

mustRun();

// 子进程成功退出后读取标准输出；失败时 mustRun() 会抛出异常。
echo $process->getOutput();

不要写成 ['php worker.php --name Alice Chen']。那会把整段文本当成一个 argv 元素，目标程序通常只能看到一个错误的可执行文件名或一个无法解析的参数。也不要用 implode(' ', $command) 代替数组模式，这会重新引入不同操作系统的 shell 解析差异。

按任务选择 run、mustRun 和 start

三个入口都可以复用同一份参数数组，区别在于错误和时序。一次性任务可用 run()；希望非零退出码立即变成异常时用 mustRun()；需要先启动、再做其他工作时用 start()。

setTimeout(30);

try {
    // mustRun() 在子进程返回非零退出码时抛出 ProcessFailedException。
    $process->mustRun(function (string $type, string $buffer): void {
        // 回调可区分标准输出和错误输出，适合记录实时进度。
        $stream = $type === Process::ERR ? 'stderr' : 'stdout';
        error_log(sprintf('[%s] %s', $stream, trim($buffer)));
    });
} catch (ProcessFailedException $exception) {
    // 保留错误输出和退出信息，避免只返回一个笼统的失败提示。
    error_log($exception->getProcess()->getErrorOutput());
    throw $exception;
}

如果子进程不能阻塞当前请求，可以改用 start()，随后通过 isRunning()、getOutput() 和 wait() 观察状态。异步不等于脱离父进程：父请求提前结束时，子进程可能随操作系统而被终止。

把工作目录、环境变量和超时一起固定

参数数组只解决命令边界，运行上下文仍要显式决定。工作目录放在构造函数第二个参数；环境变量可以放在第三个参数，或通过 run()、start() 的环境参数传入；长任务则用总超时和空闲超时避免请求无限等待。

 'batch',
    'LANG' => 'C.UTF-8',
];

// 固定 cwd 和环境，避免同一命令在不同入口目录下得到不同结果。
$process = new Process($command, __DIR__, $environment);
$process->setTimeout(120);
$process->setIdleTimeout(20);
$process->run();

// 先分别保留 stdout、stderr 和退出码，再决定业务状态。
$result = [
    'exit_code' => $process->getExitCode(),
    'stdout' => $process->getOutput(),
    'stderr' => $process->getErrorOutput(),
];

如果确实需要管道、重定向或条件运算，Symfony 文档提供了 Process::fromShellCommandline()。这不是参数数组的替代写法：它把解析责任交还给操作系统 shell，跨平台行为、转义规则和外部输入风险都要重新评估。

用四个指标确认启动结果

这类改动不应只看“页面没有报错”。可以在不改变业务逻辑的前提下，为一次子进程调用记录启动耗时、退出码、标准输出长度和错误输出。先记录原有字符串拼接方案的基线，再只把命令改成数组，比较同一批参数下的结果。

这样做的好处是能把参数边界问题和子进程自身错误分开：数组模式负责稳定地交付 argv，退出码和两条输出流负责说明交付之后发生了什么。不要把图片中的结构关系当成某次本机执行的性能结论，真正的耗时比较应在你的 PHP、操作系统和子进程版本上采样。

常见问题

带空格的参数需要自己加引号吗？

在数组模式下通常不需要。把完整值作为一个数组元素传入即可；只有使用 shell 命令字符串时，才需要按目标 shell 的规则处理引号和转义。

什么时候必须使用 fromShellCommandline？

只有当任务确实依赖 shell 的管道、重定向、通配符或条件连接时才使用。普通可执行文件加选项的调用应继续使用参数数组，以减少平台差异和转义错误。

总结起来，PHP Symfony Process 的参数数组写法就是“可执行文件、脚本、选项、值逐项排列”。再根据是否需要异常、异步、环境和超时选择对应 API，就能把子进程启动从字符串拼接改成可观察、可维护的调用。