使用exec()可捕获命令输出和返回状态，shell_exec()仅获取输出，proc_open()支持精细控制；需用escapeshellarg()等函数确保安全，并优先使用内置函数替代系统命令。
在PHP中执行系统命令并获取其输出结果和返回状态，是很多运维脚本、自动化工具或与外部程序交互场景下的常见需求。正确地捕获命令的输出和退出状态，有助于判断命令是否成功执行以及后续逻辑处理。
使用 exec() 捕获命令输出
exec() 函数可以执行一个外部命令，并将结果以字符串形式返回。它支持将命令的标准输出按行存入数组。
示例：
$command = 'ls -l';
$output = [];
$retval = 0;
exec($command, $output, $retval);
// 输出命令结果
print_r($output);
// 检查返回值（0 表示成功）
if ($retval === 0) {
echo "命令执行成功";
} else {
echo "命令执行失败，返回码：$retval";
}
注意：exec() 默认只返回最后一行输出，若要获取完整输出，必须传入第二个参数（数组）来接收所有行。
使用 shell\_exec() 获取完整输出
shell_exec() 更适合直接获取命令的完整输出内容，返回的是字符串形式的结果，但无法直接获得返回状态码。
立即学习“PHP免费学习笔记（深入）”；
$command = 'whoami';
$result = shell_exec($command);
echo "当前用户：$result";
如果需要同时获取输出和状态码，建议改用 exec() 或 passthru() 配合第三个参数。
通过 proc\_open() 精细控制命令执行
对于复杂场景，比如需要设置环境变量、处理标准错误流或超时控制，推荐使用 proc_open()。它可以完全控制输入输出流，并获取进程退出状态。
示例：
$process = proc_open(
'ls /nonexistent',
[
0 => ['pipe', 'r'], // stdin
1 => ['pipe', 'w'], // stdout
2 => ['pipe', 'w'] // stderr
],
$pipes
);
if (is_resource($process)) {
$stdout = stream_get_contents($pipes[1]);
$stderr = stream_get_contents($pipes[2]);
fclose($pipes[1]);
fclose($pipes[2]);
$status = proc_close($process);
echo "输出: $stdout\n";
echo "错误: $stderr\n";
echo "返回码: $status\n";
}
这种方式能分别捕获标准输出和标准错误，适用于调试和日志记录。
安全提示与最佳实践
执行系统命令存在安全风险，尤其是当命令包含用户输入时。
- 使用 escapeshellarg() 或 escapeshellcmd() 对参数进行转义
- 避免拼接不可信数据到命令字符串中
- 尽量使用内置PHP函数替代系统命令（如 scandir() 替代 ls）
- 限制执行权限，运行PHP的用户应具备最小必要权限
例如：
$userInput = $_GET['file'];
$safeFile = escapeshellarg($userInput);
exec("cat $safeFile", $output, $retval);
