Symfony Process实时输出异常：git clone正常输出被标记为错误

问题根源 #

git clone的进度提示、状态信息（比如Cloning into '/path'...）默认会输出到标准错误流（stderr），而非标准输出流（stdout）。这就导致Symfony Process的回调中，所有这些正常内容都会被标记为Process::ERR类型，并非Process组件的bug。

解决方案一：将git输出统一重定向到stdout #

通过shell重定向语法2>&1，把git的stderr输出转到stdout，这样Process就能把所有内容归为正常输出类型：

use Symfony\Component\Process\Process;

$process = Process::fromShellCommandline(sprintf(
    'git clone %s%s.git %s 2>&1',
    self::REPOSITORY_URL,
    $project,
    escapeshellarg($destinationPath) // 转义路径避免shell注入风险
));

$cli = $this->cli;
$process->run(static function ($type, $buffer) use ($cli) {
    if (Process::ERR === $type) {
        $cli->error($buffer);
    } else {
        $cli->print($buffer);
    }
});

注意：这里使用fromShellCommandline而非数组构造Process，因为数组模式不支持shell重定向语法，同时用escapeshellarg处理路径，避免潜在的shell注入问题。

解决方案二：结合start()与轮询实现实时输出 #

如果不想修改git命令的输出流，可以通过start()启动进程，然后轮询读取增量输出，同时处理stdout和stderr的内容：

use Symfony\Component\Process\Process;

$process = new Process(
    [
        'git',
        'clone',
        self::REPOSITORY_URL . $project . '.git',
        $destinationPath
    ]
);

$cli = $this->cli;
$process->start();

// 实时轮询进程输出
while ($process->isRunning()) {
    // 读取新增的stdout内容
    if ($stdout = $process->getIncrementalOutput()) {
        $cli->print($stdout);
    }
    
    // 读取新增的stderr内容（git的进度提示在这里）
    if ($stderr = $process->getIncrementalErrorOutput()) {
        // 可根据内容判断是否为真错误，比如包含"error:"关键字再标记为错误
        if (str_contains($stderr, 'error:')) {
            $cli->error($stderr);
        } else {
            $cli->print($stderr);
        }
    }
    
    // 短暂休眠降低CPU占用
    usleep(100000); // 0.1秒
}

// 处理进程结束后剩余的输出
if ($stdout = $process->getIncrementalOutput()) {
    $cli->print($stdout);
}
if ($stderr = $process->getIncrementalErrorOutput()) {
    if (str_contains($stderr, 'error:')) {
        $cli->error($stderr);
    } else {
        $cli->print($stderr);
    }
}

// 检查最终执行状态
if (!$process->isSuccessful()) {
    $cli->error('克隆操作失败：' . $process->getErrorOutput());
}

这种方式既保留了实时输出的能力，又能灵活区分git的正常提示和真正的错误信息。

内容的提问来源于stack exchange，提问作者Armin Markel