启用CURLOPT_ENCODING为空字符串可让cURL自动解压gzip响应,PHP 5.6.0+支持该特性,推荐优先使用此方式实现自动解压缩,无需手动处理。

PHP处理cURL请求时,如果服务器返回的是gzip压缩的响应内容,可以通过cURL选项自动解压,也可以手动检测Content-Encoding头来判断是否需要解压。以下是具体实现方式。
启用cURL自动解压(推荐)
从PHP 5.6.0开始,cURL扩展支持自动解压gzip和deflate编码的内容。只需在发起请求时设置CURLOPT_ENCODING为一个空字符串即可:
- CURLOPT_ENCODING => "":告诉cURL自动处理所有支持的压缩方式(包括gzip、deflate)
- 响应体将直接返回解压后的内容,无需手动处理
- 这是最简单且推荐的方式
示例代码:
$ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://httpbin.org/gzip"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_ENCODING, ""); // 启用自动解压 $response = curl_exec($ch); curl_close($ch); // $response 已是解压后的文本 echo $response;
手动检测Content-Encoding并解压
如果你需要控制解压逻辑或兼容旧版本PHP,可以手动获取响应头并判断是否使用了gzip压缩:
立即学习“PHP免费学习笔记(深入)”;
- 使用
CURLOPT_HEADER和CURLOPT_NOBODY配合解析头信息 - 更常见的是通过
curl_getinfo($ch, CURLINFO_CONTENT_ENCODING)获取编码类型 - 若为gzip,使用
gzdecode()函数解压原始数据
示例代码:
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://httpbin.org/gzip");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_ENCODING, ""); // 仍建议开启自动解压
$response = curl_exec($ch);
// 或者查看实际使用的编码
$encoding = curl_getinfo($ch, CURLINFO_CONTENT_ENCODING);
if ($encoding === 'gzip') {
$decoded = @gzdecode($response);
if ($decoded !== false) {
$response = $decoded;
}
}
curl_close($ch);
echo $response;
注意事项与最佳实践
- 始终优先使用
CURLOPT_ENCODING => "",让cURL自动处理压缩 - 不要重复解压:开启自动解压后,响应体已是明文,再次调用
gzdecode会出错 - 某些服务器可能返回
x-gzip,但cURL会统一识别为gzip - 确保zlib扩展已启用(PHP默认开启),否则无法解压
基本上就这些。只要设置CURLOPT_ENCODING为空字符串,PHP的cURL就能自动处理gzip响应,开发中无需额外判断。手动检测仅用于特殊场景或调试用途。











