Apache+PHP 8.0 FPM环境下进度条输出缓冲问题求助

一、修复flush输出失效的问题 #

1. PHP配置调整 #

确保php.ini中以下参数配置正确：

output_buffering = Off
implicit_flush = On

若无法修改全局配置，可在脚本开头添加代码强制关闭缓冲：

ob_end_clean(); // 关闭所有已开启的输出缓冲
ob_implicit_flush(true); // 开启隐式刷新，无需手动调用ob_flush/flush

2. Apache配置调整 #

禁用PHP脚本的gzip压缩

压缩会强制缓冲输出，必须禁用才能让flush生效，在虚拟主机配置或.htaccess中添加：

<FilesMatch \.php$>
    SetEnv no-gzip 1
</FilesMatch>

正确配置proxy_fcgi的flush参数

根据PHP-FPM的监听方式修改Apache虚拟主机配置：

• 若PHP-FPM监听端口（如9000）：

ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/你的网站根目录/$1 flushpackets=on

• 若PHP-FPM监听unix socket（如/run/php/php8.0-fpm.sock）：

ProxyPassMatch ^/(.*\.php(/.*)?)$ unix:/run/php/php8.0-fpm.sock|fcgi://localhost/你的网站根目录/$1 flushpackets=on

注意替换你的网站根目录为实际路径，比如/var/www/html

优化PHP脚本

无需生成大量填充字符，简化后的进度更新代码：

<?php
ob_end_clean();
ob_implicit_flush(true);

// 输出进度条HTML容器
echo '<div id="progress-container" style="width: 300px; border:1px solid #ccc;">
        <div id="progress-bar" style="height:20px; background:#4CAF50; width:0%;"></div>
      </div>
      <div id="progress-text"></div>';

// 模拟长任务
for ($percent = 0; $percent <= 100; $percent++) {
    $text = "当前进度：{$percent}%";
    // 输出JS更新进度
    echo "<script>
            document.getElementById('progress-bar').style.width = '{$percent}%';
            document.getElementById('progress-text').textContent = '{$text}';
          </script>";
    // 模拟任务耗时
    usleep(200000); // 200ms，总耗时约20秒
}
?>

二、更可靠的异步轮询方案 #

flush方式依赖服务器配置，容易因环境差异失效，推荐使用后台任务+AJAX轮询的方案，稳定性更高：

1. 后台任务脚本（task.php） #

负责执行长任务并记录进度：

<?php
$taskId = $_GET['task_id'];
$progressFile = "/tmp/progress_{$taskId}.txt";

// 执行长任务
for ($percent = 0; $percent <= 100; $percent++) {
    // 将进度写入临时文件（也可使用数据库/Redis）
    file_put_contents($progressFile, $percent);
    usleep(200000);
}

// 任务完成标记
file_put_contents($progressFile, 'done');
?>

2. 进度查询脚本（get_progress.php） #

返回当前任务进度：

<?php
$taskId = $_GET['task_id'];
$progressFile = "/tmp/progress_{$taskId}.txt";

echo file_exists($progressFile) ? file_get_contents($progressFile) : '0';
?>

3. 前端页面（index.php） #

发起后台任务并轮询更新进度条：

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>任务进度</title>
    <style>
        #progress-container { width:300px; border:1px solid #ccc; }
        #progress-bar { height:20px; background:#4CAF50; width:0%; transition:width 0.3s; }
    </style>
</head>
<body>
    <div id="progress-container">
        <div id="progress-bar"></div>
    </div>
    <div id="progress-text">准备开始...</div>

    <script>
        // 生成唯一任务ID
        const taskId = Math.random().toString(36).slice(2);
        
        // 启动后台任务（不等待返回）
        fetch(`task.php?task_id=${taskId}`);

        // 每1秒轮询一次进度
        const pollInterval = setInterval(() => {
            fetch(`get_progress.php?task_id=${taskId}`)
                .then(res => res.text())
                .then(progress => {
                    if (progress === 'done') {
                        clearInterval(pollInterval);
                        document.getElementById('progress-text').textContent = '任务完成！';
                        return;
                    }
                    const percent = parseInt(progress);
                    document.getElementById('progress-bar').style.width = `${percent}%`;
                    document.getElementById('progress-text').textContent = `当前进度：${percent}%`;
                });
        }, 1000);
    </script>
</body>
</html>

内容的提问来源于stack exchange，提问作者Albert C