本文介绍在 PHP 中使用 exec 安全调用长时运行 Bash 脚本时，如何实现实时输出流式展示与轻量级进度指示（如百分比/加载条），避免页面假死，并绕过 proc_open 兼容性限制。
本文介绍在 php 中使用 `exec` 安全调用长时运行 bash 脚本时，如何实现实时输出流式展示与轻量级进度指示（如百分比/加载条），避免页面假死，并绕过 `proc_open` 兼容性限制。
在 Web 环境中异步执行耗时 Bash 脚本（如数据库构建、批量导入等）时，仅靠 exec() 默认的“阻塞+一次性返回”模式无法满足用户体验需求——用户看不到进度、无法判断是否卡死。虽然 proc_open() 更适合流式读取，但正如提问者所遇，某些含复杂控制流（嵌套 for 循环、source 或 ./other.sh 调用）的脚本在 proc_open 下可能异常中断；而 exec 却能稳定执行完整流程。因此，关键在于：让 Bash 脚本自身承担“进度反馈职责”，再由 PHP 配合实现前端可视化。
✅ 推荐方案：Bash 端主动输出 + PHP 流式捕获（兼容 exec）
由于 exec 本身不支持实时回调，我们采用“伪流式”策略：
- 改造 myApp.sh：在关键步骤插入进度标识（如 echo "[PROGRESS] 35%" 或 echo "[STEP] Building database schema..."）；
- PHP 端启用 exec 的输出缓冲捕获，并配合前端 SSE（Server-Sent Events）或轮询，实现近实时更新。
▶ Step 1：增强 Bash 脚本的可观察性
在 myApp.sh 中手动标记里程碑（无需第三方工具）：
#!/bin/bash
echo "[START] Starting deployment..."
sleep 2
echo "[PROGRESS] 10% - Initializing environment"
# ... 实际命令
echo "[PROGRESS] 30% - Creating database tables"
mysql -u root -p$PASS db_name <blockquote><p>⚠️ 注意：确保所有 echo 输出未被重定向（如 >/dev/null），且避免 set -e 导致提前退出掩盖进度。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站"><img
src="https://img.php.cn/upload/skill/000/000/081/179040786932301.jpg" alt="btpanel phpsite 宝塔面板PHP网站" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站" class="overflowclass">btpanel phpsite 宝塔面板PHP网站</a>
<p class="overflowclass">宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理</p>
</div>
<a rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div></blockquote><h4>▶ Step 2：PHP 端安全执行并分块输出</h4><p>改用 exec 的<strong>数组输出模式</strong>（非字符串），结合 ob_flush() 实现服务端流式推送（需禁用输出缓冲）：</p><pre class="brush:php;toolbar:false;"><?php // disable output buffering & set headers for streaming
if (ob_get_level()) ob_end_clean();
header('Content-Type: text/event-stream');
header('Cache-Control: no-cache');
$scriptPath = '../myApp.sh';
// 安全执行：不拼接内容，直接调用脚本文件（更可靠）
$cmd = escapeshellarg('/usr/local/bin/bash') . ' ' . escapeshellarg($scriptPath) . ' 2>&1';
$output = [];
$returnCode = 0;
// 执行并捕获每行输出
exec($cmd, $output, $returnCode);
// 逐行发送到前端（模拟流式）
foreach ($output as $line) {
// 过滤并格式化进度行
if (preg_match('/^\[PROGRESS\]\s*(\d+)%/', $line, $matches)) {
echo "data: {\"type\":\"progress\",\"value\":{$matches[1]}}\n\n";
} elseif (preg_match('/^\[STEP\]/', $line)) {
echo "data: {\"type\":\"step\",\"msg\":\"" . addslashes(trim($line)) . "\"}\n\n";
} elseif (preg_match('/^\[DONE\]/', $line)) {
echo "data: {\"type\":\"done\",\"msg\":\"" . addslashes(trim($line)) . "\"}\n\n";
}
ob_flush();
flush(); // 强制推送
usleep(10000); // 10ms 微延迟，防刷屏
}
?>▶ Step 3：前端接收并渲染进度条
使用 JavaScript 监听 SSE，动态更新 UI：
<div id="progress-bar">
<div id="progress-fill" style="width: 0%; background: #4CAF50; height: 20px;"></div>
</div>
<div id="log-output"></div>
<script>
const eventSource = new EventSource("run-script.php");
eventSource.onmessage = e => {
const data = JSON.parse(e.data);
if (data.type === 'progress') {
document.getElementById('progress-fill').style.width = data.value + '%';
} else if (data.type === 'step') {
document.getElementById('log-output').innerHTML += `<div>${data.msg}`;
} else if (data.type === 'done') {
alert(data.msg);
}
};
</script>? 替代方案：轻量级 TTY 进度工具（如 tput）
若坚持使用外部进度库（如提问中提到的 progressbar），需注意：
- 该工具依赖终端特性（tput），在 exec 的非交互式环境中默认失效；
- 必须显式启用伪终端（-i 参数）并重定向 STDERR，但 exec() 不支持此行为；
- ✅ 可行变通：将 progressbar 嵌入 Bash 脚本内部，仅输出纯文本进度（非 ANSI 控制符），再由 PHP 解析：
# 在 myApp.sh 中 total=100; current=0 while [ $current -lt $total ]; do echo "[PROGRESS] $current" ((current++)) sleep 0.1 done
? 关键注意事项
- 安全性第一：永远使用 escapeshellarg() 包裹路径，禁止用户输入参与命令构造；
-
超时控制：为防止脚本失控，建议添加 timeout 命令：
timeout 1800 /usr/local/bin/bash ../myApp.sh 2>&1（1800 秒上限）； - 错误隔离：2>&1 确保 stderr 合并到 stdout，避免进度信息丢失；
- 资源监控：生产环境应配合 set_time_limit(0) 和内存限制检查，避免 PHP 进程崩溃。
通过 Bash 主动“发声” + PHP 分块解析 + 前端事件驱动，即可在 exec 的约束下优雅实现长任务可视化——无需复杂进程管理，兼顾稳定性与用户体验。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
