使用PHP执行系统命令时，应通过exec()、system()、passthru()或proc_open()获取退出码判断执行结果。其中exec()函数可通过第三个参数$return_var获取退出状态码，0表示成功，非零表示失败，并结合$output获取输出内容；system()和passthru()也支持第二个参数传引用接收退出码，适用于直接输出场景；shell_exec()仅返回输出内容，无法直接获取退出码，不推荐单独用于需状态判断的场景；对于复杂需求，proc_open()提供完全控制，可分别读取stdout和stderr并调用proc_close()获取准确退出码。无论使用哪种方式，都必须检查退出码以确认命令是否真正成功执行，不能仅依赖输出内容判断结果。
在使用PHP执行系统命令时，了解命令是否成功执行以及获取其退出状态码是非常重要的。PHP提供了多种方式来执行外部命令并获取执行结果和退出码。
使用 exec() 函数获取命令执行状态
exec() 函数用于执行一个外部命令，它的语法如下：
exec(string $command, array &$output = null, int &$return_var = null)其中第三个参数 $return_var 会接收命令执行后的退出状态码。如果命令成功执行，通常返回 0；非零值表示出错。
示例：
立即学习“PHP免费学习笔记（深入）”；
$command = 'ls /tmp';$output = [];
$exitCode = 0;
exec($command, $output, $exitCode);
if ($exitCode === 0) {
echo "命令执行成功\n";
print_r($output);
} else {
echo "命令执行失败，退出码：$exitCode\n";
}
使用 system() 和 passthru() 配合 exit code 获取
system() 会直接输出命令结果，并可接收第二个参数来保存退出状态：
system('ls /nonexistent', $exitCode);
if ($exitCode !== 0) {
echo "命令出错，退出码：$exitCode\n";
}
passthru() 同样支持第二个参数传引用以获取退出码，适用于需要原始二进制输出的场景。
使用 shell_exec() 注意事项
shell_exec() 只返回命令的输出内容，不直接提供退出码：
$output = shell_exec('ls /tmp');// 无法直接获得退出码
// 需配合其他方法或改用 exec()
因此，若需检测执行状态，建议避免单独使用 shell_exec()。
更安全可靠的方案：proc_open()
对于复杂场景，推荐使用 proc_open()，它能完全控制进程输入输出，并准确获取退出码：
$process = proc_open('ls /tmp',
[
0 => ['pipe', 'r'], // stdin
1 => ['pipe', 'w'], // stdout
2 => ['pipe', 'w'] // stderr
],
$pipes
);
if (is_resource($process)) {
$output = stream_get_contents($pipes[1]);
$errorOutput = stream_get_contents($pipes[2]);
fclose($pipes[1]); fclose($pipes[2]);
$exitCode = proc_close($process);
if ($exitCode === 0) {
echo "成功：\n" . $output;
} else {
echo "失败，错误：$errorOutput，退出码：$exitCode\n";
}
}
基本上就这些常用方法。根据需求选择合适函数，关键是要始终检查退出码判断命令是否真正成功执行。不要只依赖输出内容做判断，因为有些命令出错时也可能有部分输出。
