应直接运行composer require symfony/process安装，勿误装无关包；需确保PHP≥7.2且proc_open未禁用；run()用于短命令同步执行，start()须配wait()或isRunning()实现异步控制；超时应同时设setTimeout()和setIdleTimeout()以防假死；判断成功须综合exit code与getErrorOutput()。
symfony/process 是你要装的库，不是 php-process——后者不存在，PHP 官方没有叫这个名字的扩展或包。
直接运行 composer require symfony/process 就行，不需要框架、Bundle 或其他“配套”包。
symfony/process 怎么装才不踩坑
- 不要执行
composer require symfony/framework-bundle或composer require symfony/console：它们和symfony/process无关，只会引入冗余依赖甚至版本冲突 - 确保 PHP 版本 ≥ 7.2（官方支持到 PHP 8.4），且
proc_open函数未被禁用（检查disable_functions配置） - Windows/macOS/Linux 全平台原生支持，不用额外配置管道类型，组件内部自动选
UnixPipes或WindowsPipes - 安装后无需手动 require/autoload：只要项目已用
require 'vendor/autoload.php'，就能直接 new Process
run() 和 start() 到底该用哪个
-
run()：同步阻塞，适合短命令（ls、git status、php -v）。返回Process实例，可立刻查getExitCode() -
start()：异步启动，必须配wait()或轮询isRunning()，否则进程后台跑着、脚本却结束了 - 错误写法：
$process->start(); echo "done";→ “done”立刻输出，但进程可能还在跑，甚至泄漏资源 - 正确写法：用
wait()带回调实时捕获输出：$process->wait(function ($type, $buffer) { echo $type === Process::ERR ? "ERR: $buffer" : "OUT: $buffer"; });
超时设置为什么得设两个
只设 setTimeout(30) 不够，它只管“总耗时”，对“卡住不动”的进程无效——比如命令在等 stdin、或 stdout 长时间没新内容。
-
setTimeout(60)：从run()或start()开始计时，60 秒后强制 kill -
setIdleTimeout(15)：只要连续 15 秒没向 stdout/stderr 写入任何数据，就判定为假死，立即终止 - 两者建议同时设：
$process->setTimeout(60)->setIdleTimeout(15) - 注意：
setIdleTimeout()在部分旧版 Windows 上行为不稳定，生产环境务必实测
判断命令是否真成功，不能只看 isSuccessful()
isSuccessful() 只检查退出码是否为 0，完全不管输出内容。很多失败场景退出码仍是 0：
立即学习“PHP免费学习笔记（深入）”；
-
curl <a href="https://www.php.cn/link/b18f9c54e6efde8a08b8b478b0806587">https://www.php.cn/link/b18f9c54e6efde8a08b8b478b0806587</a>返回 HTTP 404，但退出码是 0 -
mysql -u wrong -pwrong -e "SELECT 1"认证失败，stderr 打印错误，但退出码可能是 1 —— 这时isSuccessful()返回 false，但你得靠getErrorOutput()看具体错在哪 - 正确做法：组合判断：
if ($process->getExitCode() !== 0 || !empty($process->getErrorOutput())) { /<em> 处理失败 </em>/ }
进程管理真正麻烦的从来不是启动，而是退出状态、输出流、超时边界这三者的交叉处理。漏掉任一环节，都可能让脚本在生产环境静默失败。
