PHP项目Symfony process与shell

Symfony Process 组件 vs Shell 直接执行

在 PHP 中使用 Symfony Process 组件而不是直接执行 shell 命令,有以下几个关键区别和优势：

安全性

Shell 直接执行：

$output = shell_exec("ls -la " . $userInput); // 存在命令注入风险

Symfony Process：

$process = new Process(['ls', '-la', $userInput]); // 参数自动转义
$process->run();

• Process 组件会自动转义参数，防止命令注入
• 支持参数数组形式，避免拼接字符串

错误处理

Shell 直接执行：

$output = exec("some_command");
// 难以获取正确的退出码和错误信息

Symfony Process：

$process = new Process(['some_command']);
$process->run();
if (!$process->isSuccessful()) {
    throw new ProcessFailedException($process);
}
echo $process->getExitCode(); // 退出码
echo $process->getErrorOutput(); // 错误输出
echo $process->getOutput(); // 标准输出

实时输出监控

Shell 直接执行： 通常需要等待命令完成

Symfony Process：

$process = new Process(['long_running_command']);
$process->run(function ($type, $buffer) {
    if (Process::ERR === $type) {
        echo 'ERR > '.$buffer;
    } else {
        echo 'OUT > '.$buffer;
    }
});

超时控制

$process = new Process(['some_command']);
$process->setTimeout(60); // 设置超时时间
$process->setIdleTimeout(30); // 设置空闲超时
try {
    $process->run();
} catch (ProcessTimedOutException $e) {
    // 处理超时
}

工作目录和环境变量

$process = new Process(['php', 'script.php']);
$process->setWorkingDirectory('/path/to/project');
$process->setEnv(['APP_ENV' => 'production']);
$process->setTimeout(300);

异步执行

$process = new Process(['long_task']);
$process->start(); // 异步启动
// 做其他事情...
// 等待完成
$process->wait();
// 或检查是否完成
if ($process->isRunning()) {
    // 仍在运行
}

信号处理

$process = new Process(['long_running_script']);
$process->start();
// 发送信号
$process->signal(SIGTERM); // 发送终止信号
$process->signal(SIGKILL); // 强制终止

实际使用示例

use Symfony\Component\Process\Process;
use Symfony\Component\Process\Exception\ProcessFailedException;
class CommandExecutor
{
    public function executeComposerInstall(string $projectPath): string
    {
        $process = new Process(
            ['composer', 'install', '--no-dev', '--optimize-autoloader'],
            $projectPath,
            ['COMPOSER_MEMORY_LIMIT' => '-1'],
            null,
            300 // 5分钟超时
        );
        try {
            $process->mustRun(function ($type, $buffer) {
                if (Process::OUT === $type) {
                    echo $buffer;
                }
            });
            return $process->getOutput();
        } catch (ProcessFailedException $exception) {
            throw new \RuntimeException('Composer install failed: ' . $exception->getMessage());
        }
    }
}

建议： 在 Symfony 项目或任何 PHP 项目中，优先使用 Process 组件而不是直接执行 shell 命令,特别是在处理用户输入或需要可靠错误处理时。