gzencode 返回二进制 gzip 数据,直接 echo 会显示乱码;需 binary 传输或 base64 编码后调试;默认兼容 gzip 工具,压缩级别 0–9 可调,0 为无压缩仅加头尾。

gzencode 压缩字符串时返回的是二进制数据,不是 Base64 或可读文本
直接 echo gzencode("hello") 会看到乱码甚至终端异常,因为输出的是原始 gzip 格式字节流。浏览器或终端无法渲染它,但其他程序(如 HTTP 客户端、PHP 的 gzdecode)能正确处理。
- 压缩后数据必须以
binary方式传输或存储,比如通过 HTTP headerContent-Encoding: gzip - 若需日志记录、调试或跨系统传递,应先用
base64_encode(gzencode($str))编码为 ASCII 字符串 -
gzencode默认使用 ZLIB_ENCODING_GZIP(即 RFC 1952 标准),和命令行gzip工具兼容
压缩级别控制:第三个参数影响大小与 CPU 开销
gzencode 第三个参数是压缩级别,取值范围是 0(无压缩)到 9(最高压缩),默认为 ZLIB_DEFAULT_COMPRESSION(通常等价于 -1,由 zlib 自动选择平衡点)。
- 设为
0:相当于只加 gzip 头尾,不压缩内容,速度快,体积略增(约 20 字节开销) - 设为
1:快速压缩,适合实时场景(如 API 响应) - 设为
9:压缩率高但耗 CPU,小字符串( - 注意:PHP 8.0+ 中该参数类型为
int,传字符串(如"9")会静默转为0
解压失败常见原因:数据被意外修改或编码污染
调用 gzdecode 报错 Warning: gzdecode(): data error,多数不是压缩逻辑问题,而是中间环节破坏了二进制完整性。
- 把
gzencode结果存进 MySQLTEXT字段(而非BLOB)会导致截断或字符集转换(如 utf8mb4 强制校验) - 经 URL 参数传递未用
rawurlencode(),空格、斜杠、加号等被篡改 - 用
json_encode()包裹二进制数据 —— JSON 不支持二进制,会强制转成 Unicode 替换符() - 正确做法:存储用
BLOB,传输用base64_encode()+json_encode(),接收后base64_decode()再gzdecode()
替代方案对比:gzdeflate vs gzencode vs zlib_encode
三者都做 DEFLATE 压缩,但封装格式不同,互不兼容:
立即学习“PHP免费学习笔记(深入)”;
-
gzencode()→ 输出标准 gzip 格式(含魔数 1f 8b、头信息、CRC),可用gunzip命令直接解 -
gzdeflate()→ 纯 DEFLATE 流(RFC 1951),无头尾,PHP 内部常用,但和其他语言对接需额外封装 -
zlib_encode($data, ZLIB_ENCODING_DEFLATE)→ 同gzdeflate;ZLIB_ENCODING_GZIP则等效gzencode - 不要混用:用
gzencode压缩的数据,必须用gzdecode解,不能用gzinflate
gzencode,先想清楚:这串 bytes 下一步去哪?是否经过任何“看起来无害”的字符串处理函数?











