PHP 7.2 的 exec 函数不支持超时参数，因其为阻塞式调用且无法中断子进程；必须用 proc_open + stream_select 手动实现超时控制，通过监控管道流并在超时后调用 proc_terminate 强制终止进程。
PHP 7.2 的 exec 函数本身不支持超时参数，硬等命令返回会导致脚本卡死、响应延迟甚至 504；必须用 proc_open + stream_select 手动实现超时控制。
为什么 exec() 不能直接设超时
exec 是阻塞式调用，它会一直等到子进程退出才返回——哪怕命令卡在某个系统调用里（比如网络等待、磁盘阻塞），PHP 层面完全无法干预。PHP 7.2 没有给 exec 加入 $timeout 参数，官方也明确不打算加（因 POSIX 层无统一中断机制）。
常见误操作包括：
- 在
exec后加set_time_limit(5)—— 这只限制 PHP 脚本总执行时间，不中断已启动的外部进程 - 用
pcntl_alarm配合信号捕获 —— 在 Web SAPI（如 FPM）中不可靠，且 PHP 7.2 默认禁用 pcntl 扩展 - 依赖
shell_exec('timeout 5 cmd')—— Linuxtimeout命令在容器或精简系统中常不存在，Windows 更不支持
proc_open + stream_select 实现精确超时
这是 PHP 7.2 下最稳定、可移植的方案：启动进程后，只监控 stdout/stderr 管道是否有数据可读，超时即终止进程。
立即学习“PHP免费学习笔记（深入）”；
关键点：
-
proc_open必须显式定义$descriptorspec，不能留空，否则stream_select无法监听 -
stream_select的超时单位是「秒 + 微秒」，传[10, 0]表示 10 秒，传[0, 500000]表示 500ms - 调用
proc_terminate($process, 9)发送 SIGKILL（非 SIGTERM），确保顽固进程被真正杀掉 - 务必
fclose所有$pipes，否则资源泄漏，多次调用后可能耗尽文件描述符
最小可用示例：
function execWithTimeout($cmd, $timeout = 10) {
$descriptors = [
0 => ['pipe', 'r'],
1 => ['pipe', 'w'],
2 => ['pipe', 'w']
];
$process = proc_open($cmd, $descriptors, $pipes);
if (!is_resource($process)) {
return ['output' => [], 'return_code' => -1, 'error' => 'proc_open failed'];
}
$read = [$pipes[1], $pipes[2]];
$write = $except = [];
$n = stream_select($read, $write, $except, $timeout);
if ($n === false) {
proc_terminate($process, 9);
proc_close($process);
return ['output' => [], 'return_code' => -2, 'error' => 'stream_select error'];
}
if ($n === 0) {
proc_terminate($process, 9);
$return_code = proc_close($process);
return ['output' => [], 'return_code' => $return_code, 'error' => 'timeout'];
}
$output = stream_get_contents($pipes[1]);
$error = stream_get_contents($pipes[2]);
fclose($pipes[1]);
fclose($pipes[2]);
$return_code = proc_close($process);
return [
'output' => explode("
", trim($output)),
'error' => trim($error),
'return_code' => $return_code
];
}
exec 调用前必须做的三件事
超时逻辑再完善，如果 exec 根本没权限运行，一切白搭。PHP 7.2 环境下，以下检查缺一不可：
- 确认
exec未被禁用：ini_get('disable_functions')返回字符串里不能含exec，改完 php.ini 后必须重启 PHP-FPM（systemctl restart php7.2-fpm或类似） - 区分 CLI 和 Web SAPI 配置：Web 页面中
phpinfo()显示的Loaded Configuration File和命令行php -i | grep "Loaded Configuration File"结果很可能不同，两个地方都要查 - 命令路径要写全：Web 进程的
$PATH通常极简（如只有/usr/bin），ffmpeg或convert这类工具大概率不在其中，必须用绝对路径，例如/usr/bin/ffmpeg -i ...
带空格路径和特殊字符怎么安全拼接
直接拼接 "$path/to app.exe" 会失败，因为 shell 把空格当分隔符。PHP 不会自动加引号，你得自己包好。
正确做法：
- Linux/macOS：用单引号包裹整个路径，内部单引号需转义为
'''；更稳妥是用escapeshellarg()，它专为此设计 - Windows：双引号即可，但注意 PHP 字符串中反斜杠要写成
\，或直接用正斜杠C:/Program Files/app.exe - 避免手动拼接命令：把参数单独传进数组，用
escapeshellarg()处理每个变量，再implode(' ', $args)
错误示例：exec("C:Program Files fmpeg.exe -i {$input}");
正确示例：exec(escapeshellarg('/usr/bin/ffmpeg') . ' -i ' . escapeshellarg($input) . ' -y ' . escapeshellarg($output));
超时控制本身不难，难的是在 PHP 7.2 这个「半废弃」版本上，既要绕过 pcntl 缺失、又要兼容 FPM 的信号限制、还要应付各种 disable_functions 和 PATH 差异——漏掉任意一环，proc_open 写得再漂亮也会静默失败。
