php 的 `shell_exec()` 默认只捕获标准输出（stdout），而像 `pdftotext -v` 这类工具通常将版本信息输出到标准错误（stderr），导致返回 `null`；需通过 `2>&1` 重定向 stderr 到 stdout 才能正确获取结果。
在 Laravel（或任何 PHP 环境）中构建诊断端点时，调用系统命令如 pdftotext -v、convert -version 或 ffmpeg -version 时，常遇到 shell_exec() 返回 null 或空字符串，而相同命令在终端中执行却能正常输出——这并非权限或路径问题，而是输出流重定向缺失所致。
为什么终端能显示，PHP 却不行？
Linux/Unix 系统中，程序默认有三个标准流：
- stdout（文件描述符 1）：常规成功输出（echo “ok” → stdout）
- stderr（文件描述符 2）：错误、警告及部分工具的诊断信息（如 -v, –version）
- stdin（文件描述符 0）：输入流
许多命令行工具（尤其是 ImageMagick、Poppler 工具集如 pdftotext、pdfinfo，以及旧版 pdftohtml）为兼容 POSIX 规范，将版本号、帮助文本等非核心输出写入 stderr，而非 stdout。因此：
# 终端中 shell 会同时显示 stdout 和 stderr → 看起来“正常”
$ pdftotext -v
pdftotext version 21.12.0
# 但 PHP 的 shell_exec() 仅捕获 stdout → 实际上 stderr 被丢弃
shell_exec('pdftotext -v'); // → null
正确做法：重定向 stderr 到 stdout
使用 2>&1 将标准错误重定向至标准输出流，使 shell_exec() 一并捕获：
立即学习“PHP免费学习笔记（深入）”；
// ✅ 正确：捕获 stderr + stdout
$version = trim(shell_exec('pdftotext -v 2>&1'));
dump($version); // "pdftotext version 21.12.0"
// ✅ 同样适用于其他工具
$imagemagick = trim(shell_exec('convert -version 2>&1'));
$ffmpeg = trim(shell_exec('ffmpeg -version 2>&1 | head -n 1')); // 取首行避免冗长
? 提示：2>&1 必须写在命令末尾，且不能加空格（2> &1 错误）。& 表示后台执行，此处是重定向语法的一部分。
补充验证方式（推荐用于诊断）
若仍不确定输出流向，可显式分离并检查：
// 分别捕获 stdout 和 stderr（需临时文件，仅调试用）
exec('pdftotext -v > /tmp/stdout.txt 2> /tmp/stderr.txt');
$stdout = file_get_contents('/tmp/stdout.txt');
$stderr = file_get_contents('/tmp/stderr.txt');
dump(['stdout' => $stdout, 'stderr' => $stderr]); // 通常 $stdout 为空，$stderr 有版本号
Laravel 诊断端点示例（安全增强版）
// routes/web.php 或 API 控制器中
Route::get('/diag/tools', function () {
$tools = [
'pdftotext' => 'pdftotext -v',
'pdfinfo' => 'pdfinfo -v',
'convert' => 'convert -version',
'php' => 'php -v',
];
$results = [];
foreach ($tools as $name => $cmd) {
// ✅ 安全：白名单命令 + 严格转义（实际生产建议用 escapeshellarg 对动态参数）
$output = trim(shell_exec($cmd . ' 2>&1'));
$results[$name] = $output ?: 'not found or failed';
}
return response()->json([
'timestamp' => now()->toISOString(),
'tools' => $results,
]);
});
注意事项与最佳实践
- ? 安全性：避免拼接用户输入到命令中；如需动态参数，务必使用 escapeshellarg()。
- ? 禁用函数检查：确认 shell_exec 未被 disable_functions 禁用（查看 phpinfo() 或 ini_get(‘disable_functions’)）。
- ? 环境一致性：Vapor、Docker、Mac 本地等环境 PATH 可能不同，建议使用绝对路径（如 /usr/local/bin/pdftotext -v）或在部署时确保 PATH 正确。
- ? 超时控制：长时间运行命令可能导致请求阻塞，可配合 set_time_limit(5) 或改用异步队列处理复杂诊断。
通过理解 stdout/stderr 的行为差异，并主动添加 2>&1，即可稳定、可靠地从 PHP 获取各类 CLI 工具的版本与状态信息，为运维监控和故障排查提供坚实基础。