如何通过PHP设置_gzhandler实现Gzip压缩优化页面加载？

本文共计956个文字，预计阅读时间需要4分钟。

直接说结论：

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）、乱码或空响应。

立即学习“PHP免费学习笔记（深入）”；

• 如果 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')，只是递了一张入场券，能不能进场，得看服务器、客户端、缓冲层三方同时点头。