ob_gzhandler 并非“一加就压缩”，仅在满足全部条件时生效；多数失效源于 php 输出缓冲、客户端请求头或 web 服务器配置冲突，而非代码错误；必须在任何输出前注册，且文件须为 utf-8 无 bom 编码。
直接说结论：ob_gzhandler 不是“一加就压缩”，它只在满足全部条件时才生效；多数失效场景和 PHP 输出缓冲、客户端请求头、Web 服务器配置冲突有关，不是代码写错了。
ob_gzhandler 必须在输出前注册，且不能有前置输出
PHP 一旦开始输出（哪怕是一个空格、BOM、echo ''、?> 后的换行），ob_start('ob_gzhandler') 就会失败，并抛出 Warning: ob_start(): output handler 'ob_gzhandler' cannot be used after by a previous handler。
- 检查文件开头是否有 UTF-8 BOM：用 VS Code 或 Notepad++ 切换到“编码 → UTF-8 无 BOM”保存
- 确认没在
<?php前写 HTML、注释或空白行 - 框架项目（如 Laravel、ThinkPHP）通常已启动输出缓冲，调用
ob_start('ob_gzhandler')前先运行var_dump(ob_list_handlers())看是否已有 handler - 别在
include或函数里调用它——必须放在入口脚本最顶部、<?php后立刻执行
ob_gzhandler 只压缩特定类型，且依赖客户端协商
它不会压缩所有响应，而是按 MIME 类型 + 请求头双重判断：仅当 $_SERVER['HTTP_ACCEPT_ENCODING'] 包含 gzip，且输出内容类型属于白名单（如 text/html、application/json、application/javascript）时才触发压缩。
- 图片、PDF、ZIP 等二进制响应永远不压缩，
ob_gzhandler对它们完全静默 - 若用
header('Content-Type: image/svg+xml')返回 SVG，需确保该类型在gzip_types中（Nginx 场景下更关键） - curl 默认不发
Accept-Encoding头，测试时务必加：curl -H "Accept-Encoding: gzip" -I http://localhost/test.php - 响应体太小（默认阈值约 20 字节）会被跳过，可临时加长内容验证：
echo str_repeat('x', 1024)
别和 Web 服务器或 php.ini 的 zlib 冲突
Apache/Nginx 的 Gzip 和 PHP 的 zlib.output_compression 优先级都高于 ob_gzhandler。三者共存极易导致双重压缩（Content-Encoding: gzip, gzip）、乱码或空响应。
- 如果 Nginx 已配
gzip on，就关掉zlib.output_compression = Off，且不要用ob_gzhandler - 如果必须用
ob_gzhandler（比如共享主机无法改 Nginx），请确认zlib.output_compression = Off且未启用 Apache 的mod_deflate - 宝塔面板开启 Gzip 后，
ob_gzhandler会失效——因为 Nginx 已接管压缩，PHP 层再压一次就崩了 - 用
phpinfo()查看zlib.output_compression和zlib.output_compression_level实际值，别只信配置文件
怎么确认它真在工作？别只看响应头
看到 Content-Encoding: gzip 不代表 PHP 输出被压缩了——可能是 Nginx 压缩了静态 CSS/JS，也可能是缓存返回的老响应。
- 用
curl -H "Accept-Encoding: gzip" -s -w "%{size_download}\n" -o /dev/null http://yoursite.com/test.php对比开启/关闭ob_gzhandler时的下载字节数 - 临时禁用 CDN（如 Cloudflare 的代理），避免中间层剥离
Accept-Encoding或覆盖响应头 - 在脚本里加一句
header('X-Gzip-Status: '.(function_exists('gzencode') ? 'enabled' : 'missing'));辅助排查 zlib 扩展状态 - 若用 PHP-FPM，注意
fastcgi_buffering off可能干扰压缩流，但一般无需动它
真正容易被忽略的是：ob_gzhandler 是协商式压缩，它不控制何时压缩、对谁压缩、压多少——这些全由环境决定。你写的那行 ob_start('ob_gzhandler')，只是递了一张入场券，能不能进场，得看服务器、客户端、缓冲层三方同时点头。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
