通过 exec 启动长时 Bash 脚本时，无法直接获取实时输出；但借助 proc_open 配合流式读取（而非 exec），可实现命令逐行输出、进度条渲染及用户友好反馈——本文提供稳定、兼容性强的完整解决方案。
通过 `exec` 启动长时 bash 脚本时，无法直接获取实时输出；但借助 `proc_open` 配合流式读取（而非 `exec`），可实现命令逐行输出、进度条渲染及用户友好反馈——本文提供稳定、兼容性强的完整解决方案。
在 Web 环境中异步执行耗时 Bash 脚本（如数据库构建、批量导入、多级脚本调用）并实时反馈进度，是运维类 PHP 应用的核心需求。虽然提问者提到 proc_open “不工作”，但实际问题往往源于使用方式不当（如未正确设置管道、未循环读取 stdout/stderr 或忽略缓冲区刷新），而非 proc_open 本身限制——它完全支持 for 循环、子脚本调用等任意 Bash 特性。
✅ 正确做法：改用 proc_open 替代 exec，建立非阻塞管道，边执行边输出：
<?php
$scriptPath = __DIR__ . '/../myApp.sh';
$descriptors = [
0 => ['pipe', 'r'], // stdin
1 => ['pipe', 'w'], // stdout → 实时捕获
2 => ['pipe', 'w'] // stderr → 一并捕获便于调试
];
$process = proc_open(
"/usr/local/bin/bash " . escapeshellarg($scriptPath) . " 2>&1",
$descriptors,
$pipes,
dirname($scriptPath),
$_ENV
);
if (!is_resource($process)) {
die("Failed to start script");
}
// 设置 stdout/stderr 为非阻塞模式
stream_set_blocking($pipes[1], false);
stream_set_blocking($pipes[2], false);
echo "<pre id='output' style='background:#f5f5f5; padding:12px; font-family:monospace; white-space:pre-wrap;'></pre>";
echo "<script>
let outputEl = document.getElementById('output');
function append(text) { outputEl.innerHTML += text + '\n'; outputEl.scrollTop = outputEl.scrollHeight; }
</script>";
// 实时读取并输出
while (proc_get_status($process)['running']) {
$stdout = stream_get_contents($pipes[1]);
$stderr = stream_get_contents($pipes[2]);
if ($stdout !== '') {
echo "<script>append(" . json_encode(trim($stdout)) . ");</script>";
ob_flush();
flush();
}
if ($stderr !== '') {
echo "<script>append(" . json_encode('[ERROR] ' . trim($stderr)) . ");</script>";
ob_flush();
flush();
}
usleep(100000); // 100ms 间隔，避免高频轮询
}
// 获取剩余输出
$stdout = stream_get_contents($pipes[1]);
$stderr = stream_get_contents($pipes[2]);
if ($stdout) echo "<script>append(" . json_encode(trim($stdout)) . ");</script>";
if ($stderr) echo "<script>append(" . json_encode('[ERROR] ' . trim($stderr)) . ");</script>";
fclose($pipes[0]);
fclose($pipes[1]);
fclose($pipes[2]);
proc_close($process);
?>? 关键注意事项：
- ✅ Bash 脚本需主动刷新输出：在 myApp.sh 中对关键步骤添加 echo "STEP: DB initialized" 并搭配 stdbuf -oL（行缓冲）或 echo -n "." && echo "" 强制换行，避免因缓冲导致延迟；
- ✅ 禁用输出缓冲：PHP 端务必调用 ob_flush() + flush()，且确保 output_buffering = Off（php.ini）或运行时 ini_set('output_buffering', 'Off')；
- ✅ 进度条增强方案：若脚本逻辑可控，可在 Bash 中嵌入 progress $current $total（如 realSpok/progressbar），配合正则匹配 Progress: (d+)% 提取百分比，动态更新前端 <progress> 元素；
- ⚠️ exec 本质是同步阻塞调用，无法实时返回中间结果——坚持用 exec 就等于放弃实时反馈，这不是限制，而是设计约束。
最终效果：用户页面持续滚动显示每条命令输出，错误高亮提示，配合简单 CSS 进度条即可实现专业级任务可视化。这才是兼顾稳定性、兼容性与用户体验的生产就绪方案。
立即学习“PHP免费学习笔记（深入）”；
