gzencode正确用法是将字符串压缩为标准GZIP二进制数据，需以'wb'模式写入文件、配合Content-Encoding: gzip响应头输出，并禁用zlib.output_compression以防双重压缩。
gzencode 函数压缩字符串的正确用法
PHP 的 gzencode 不是直接“存储网页资源”的工具，它只负责把一段字符串按 Gzip 格式压缩成二进制数据。你要存的是压缩后的内容，不是原始 HTML 或 JS；浏览器也不会自动解压你随便存的 .gz 文件——必须配合正确的 HTTP 响应头或服务器配置才能生效。
常见错误是：调用 gzencode($html) 后直接 file_put_contents('index.html.gz', $compressed)，然后以为访问 index.html.gz 就能被浏览器正常显示。实际上，没有 Content-Encoding: gzip 响应头，浏览器会把它当普通二进制文件下载，或报错解析失败。
-
gzencode默认使用 ZLIB_ENCODING_GZIP（即标准 Gzip 格式），兼容性最好，别改$level参数除非明确需要权衡速度和压缩率 - 压缩后的数据是二进制，写入文件时务必用
'wb'模式（如fopen($file, 'wb')），否则 Windows 下可能损坏数据 - 若想让 Nginx/Apache 直接服务这些预压缩文件，需额外开启
gzip_static on（Nginx）或mod_deflate + mod_headers配合规则，不能只靠 PHP 写文件
压缩后如何让浏览器正确识别并解压
单纯生成 .gz 文件没用，关键在响应阶段。PHP 脚本输出压缩内容时，必须设置两个东西：Content-Encoding: gzip 头，以及关闭输出缓冲干扰（否则 zlib.output_compression 可能二次压缩出错）。
示例场景：动态生成静态页缓存，先用 gzencode 存为 cache/page_123.html.gz，再由同一脚本读取并输出：
立即学习“PHP免费学习笔记（深入）”；
header('Content-Encoding: gzip');
header('Content-Type: text/html; charset=utf-8');
header('Vary: Accept-Encoding');
readfile('cache/page_123.html.gz');
注意：readfile 必须在所有 header() 之后，且前面不能有任何输出（包括空格、BOM）。如果启用了 zlib.output_compression，必须关掉，否则会尝试对已压缩内容再压缩，导致浏览器解压失败并报 ERR_CONTENT_DECODING_FAILED。
与 ob_gzhandler、zlib.output_compression 的冲突点
PHP 自带的两种运行时压缩机制（ob_gzhandler 输出回调、zlib.output_compression ini 设置）和手动 gzencode 是互斥的。混用会导致双重压缩或头部混乱。
- 若用
gzencode预压缩文件并readfile输出，必须确保zlib.output_compression = Off，且没调用ob_start('ob_gzhandler') - 检查是否已开启：用
ini_get('zlib.output_compression')或ini_get('output_handler')；若返回非空值，就得显式关掉 - 常见陷阱：本地开发关了，但生产环境 php.ini 里开了
zlib.output_compression=On，结果页面变成乱码或空白
预压缩静态资源的实用边界
用 gzencode 手动压缩适合「变动不频繁 + 访问量大」的资源，比如 CMS 生成的静态 HTML、CSS、JS 文件。但要注意：
- 文本类资源（HTML/CSS/JS）压缩收益明显；图片、字体、视频本身已压缩，再套 Gzip 反而可能变大
- PHP 进程每次读取
.gz文件再输出，比 Web 服务器直接 sendfile 效率低；Nginx 的gzip_static on才是更优解 - 若资源有 ETag 或 Last-Modified，压缩后要同步更新对应头，否则缓存校验会失效
真正省事的做法是：用 PHP 生成原始文件后，用 shell 命令 gzip -k file.js 生成 file.js.gz，再交由 Nginx 静态服务——gzencode 更适合做中间处理，而非最终交付环节。
