php 的 json_encode() 不负责 gzip 压缩，实际压缩由 web 服务器（如 nginx）或 php zlib 输出缓冲完成；nginx 需显式配置 gzip_types 包含 application/json 才能压缩 json 响应。
PHP 返回 JSON 时启用 gzip 压缩靠的是 Web 服务器，不是 json_encode()
PHP 本身不负责 HTTP 响应体的压缩传输，json_encode() 只生成字符串。真正压缩响应内容（比如 JSON）的是 Web 服务器（如 Nginx、Apache）或 PHP 的 zlib 输出缓冲机制。直接调用 json_encode() 后 echo，不开启输出压缩，浏览器收到的就是原始字节流。
常见错误现象：
– 前端看到响应头没有 Content-Encoding: gzip
– Network 面板显示 Transferred 大小和 Content 大小几乎一致
– ob_gzhandler 没生效，反而报错 “headers already sent”
- 优先确认 Web 服务器是否已开启 gzip（更稳定、性能更好）
- 若无法改服务器配置，再考虑 PHP 层用
ob_start('ob_gzhandler')，但需确保在任何输出前调用，且 PHP 编译时启用了 zlib - 检查
zlib.output_compression是否在php.ini中设为On（不推荐，它会干扰 header 发送）
Nginx 下正确开启 JSON 响应 gzip 压缩的关键配置
Nginx 默认只对 text/html 压缩，JSON 响应（application/json）默认不被包含，必须显式添加 MIME 类型。
在 nginx.conf 或站点 server 块中确认以下配置存在：
立即学习“PHP免费学习笔记（深入）”；
gzip on; gzip_types application/json text/plain text/css application/javascript;
注意点：
-
gzip_types必须包含application/json，否则即使响应头是Content-Type: application/json，Nginx 也不会压缩 - 不要写成
application/*—— Nginx 不支持通配符匹配 - 如果用了
gzip_vary on，确保后端 PHP 没重复设置Vary: Accept-Encoding，否则可能引发缓存异常 - 小 JSON（gzip_min_length 10 调低阈值（慎用，太小反而增加开销）
PHP 手动触发 zlib 压缩的边界条件和风险
仅当无法控制 Web 服务器时才考虑 PHP 层压缩，典型场景：共享主机、某些 PaaS 环境。
可行做法（需放在脚本最开头，无任何输出前）：
<?php
if (isset($_SERVER['HTTP_ACCEPT_ENCODING']) && strpos($_SERVER['HTTP_ACCEPT_ENCODING'], 'gzip') !== false) {
if (function_exists('ob_gzhandler')) {
ob_start('ob_gzhandler');
}
}
header('Content-Type: application/json; charset=utf-8');
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
?>
容易踩的坑：
-
ob_gzhandler和zlib.output_compression同时启用会导致双重压缩，浏览器解压失败 - 如果之前已调用过
echo、print、甚至空白字符或 BOM，ob_start()会失效并警告“headers already sent” -
json_encode()的JSON_INVALID_UTF8_IGNORE等选项不影响压缩，但若数据含非法 UTF-8，压缩前就可能出错
验证 JSON 是否真被压缩的三个硬指标
别只看响应头，要交叉验证：
- Network 面板中查看该请求的
Content-Encoding响应头是否为gzip - 对比 “Size”（实际传输大小）和 “Content”（解压后大小），差值明显（比如 3KB → 800B）才说明生效
- 用 curl 测试：
curl -H "Accept-Encoding: gzip" -I http://yoursite/api.php，观察返回头是否有Content-Encoding: gzip和Vary: Accept-Encoding
最容易被忽略的一点：前端 fetch 或 axios 默认自动解压 gzip 响应，你看到的 response.json() 总是解压后的结果 —— 所以压缩是否生效，必须看 DevTools Network 的原始传输尺寸，而不是 console.log 出来的数据体积。
