LeCMS
ClassCMS
Fastadmin
iCMS
PbootCMS
PHPCMS
易优CMS
YzmCMS
讯睿CMS
极致CMS
Wordpress
HkCMS
YznCMS
WellCMS
ThinkCMF
帝国CMS
SIYUCMS在 Nginx 环境下，PHP 的 flush() 或 ob_flush() 函数可能无法立即将输出发送到客户端，这是因为 Nginx 的缓冲机制和 PHP 的配置可能会导致输出延迟。以下是解决 flush() 失效的常见方法。
1. 问题原因
Nginx 缓冲：Nginx 默认会缓冲来自 FastCGI（如 PHP-FPM）的响应，以提高性能。
PHP 输出缓冲：PHP 可能启用了输出缓冲（
output_buffering），导致flush()无法立即生效。浏览器缓冲：某些浏览器可能会缓冲接收到的数据。
2. 解决方法
方法 1：禁用 Nginx 的 FastCGI 缓冲
通过修改 Nginx 配置文件，禁用 FastCGI 缓冲。
修改 Nginx 配置文件
在 Nginx 的 server 或 location 块中添加以下配置：
location ~ \.php$ {
fastcgi_buffering off; # 禁用 FastCGI 缓冲
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # 根据实际情况修改
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;}重启 Nginx
sudo systemctl restart nginx
方法 2：禁用 PHP 的输出缓冲
在 PHP 脚本中禁用输出缓冲。
修改 PHP 脚本
在 PHP 脚本的开头添加以下代码：
<?php// 禁用输出缓冲ini_set('output_buffering', 'off');ini_set('zlib.output_compression', false);// 刷新输出缓冲区while (ob_get_level() > 0) {
ob_end_flush();}?>方法 3：手动刷新缓冲区
在 PHP 脚本中手动调用 flush() 和 ob_flush()。
示例代码
<?php// 禁用输出缓冲ini_set('output_buffering', 'off');ini_set('zlib.output_compression', false);// 刷新输出缓冲区while (ob_get_level() > 0) {
ob_end_flush();}// 输出内容并刷新echo "Start...<br>";flush();ob_flush();sleep(1);echo "Processing...<br>";flush();ob_flush();sleep(1);echo "Done!<br>";flush();ob_flush();?>方法 4：设置 HTTP 头禁用浏览器缓冲
通过设置 HTTP 头，禁用浏览器的缓冲。
示例代码
<?php// 设置 HTTP 头header('Content-Encoding: none'); // 禁用压缩header('Cache-Control: no-cache'); // 禁用缓存header('X-Accel-Buffering: no'); // 禁用 Nginx 缓冲// 输出内容并刷新echo "Start...<br>";flush();ob_flush();sleep(1);echo "Processing...<br>";flush();ob_flush();sleep(1);echo "Done!<br>";flush();ob_flush();?>方法 5：调整 Nginx 的 FastCGI 缓冲大小
如果不想完全禁用 FastCGI 缓冲，可以调整缓冲大小。
修改 Nginx 配置文件
在 Nginx 的 server 或 location 块中添加以下配置：
location ~ \.php$ {
fastcgi_buffer_size 4k; # 设置缓冲区大小为 4KB
fastcgi_buffers 16 4k; # 设置缓冲区数量和大小
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # 根据实际情况修改
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;}重启 Nginx
sudo systemctl restart nginx
3. 测试方法
使用以下 PHP 脚本测试 flush() 是否生效：
<?php// 禁用输出缓冲ini_set('output_buffering', 'off');ini_set('zlib.output_compression', false);// 设置 HTTP 头header('Content-Encoding: none');header('Cache-Control: no-cache');header('X-Accel-Buffering: no');// 刷新输出缓冲区while (ob_get_level() > 0) {
ob_end_flush();}// 输出内容并刷新for ($i = 1; $i <= 5; $i++) {
echo "Step $i<br>";
flush();
ob_flush();
sleep(1);}?>如果每一步的输出都能立即显示在浏览器中，说明 flush() 已生效。
4. 总结
在 Nginx 环境下，解决 PHP flush() 失效的常见方法包括：
禁用 Nginx 的 FastCGI 缓冲：通过
fastcgi_buffering off实现。禁用 PHP 的输出缓冲：通过
ini_set()或ob_end_flush()实现。手动刷新缓冲区：在 PHP 脚本中调用
flush()和ob_flush()。设置 HTTP 头：禁用浏览器和 Nginx 的缓冲。
调整 FastCGI 缓冲大小：通过
fastcgi_buffer_size和fastcgi_buffers实现。
根据实际需求选择合适的方法，可以有效解决 flush() 失效的问题。
本文关键词： Nginx 环境 PHP flush 失效 解决
希望以上内容对你有所帮助！如果还有其他问题，请随时提问。 各类知识收集 拥有多年CMS企业建站经验，对 iCMS， LeCMS， ClassCMS， Fastadmin， PbootCMS， PHPCMS， 易优CMS， YzmCMS， 讯睿CMS， 极致CMS， Wordpress， HkCMS， YznCMS， WellCMS， ThinkCMF， 等各类cms的相互转化，程序开发，网站制作，bug修复，程序杀毒，插件定制都可以提供最佳解决方案。
