PHP调用返回zip文件的第三方API时如何将响应存为zip到服务器指定目录

核心原理 #

你拿到编码形式的响应，本质是请求时默认将响应当做文本处理，做了自动编码转换，或者没有正确处理二进制响应。你只需要直接将接口返回的二进制原始内容写入文件即可，不需要额外做编解码转换。

方案1：cURL实现（推荐，可控性强） #

这是最常用的方案，适配大部分接口场景，支持自定义请求头、超时、认证等参数：

<?php
// 第三方API地址
$apiUrl = 'https://third-party-api.com/endpoint/get-zip';
// 服务器存储路径，确保对应目录有写入权限
$savePath = '/your/server/path/target.zip';

// 初始化cURL
$ch = curl_init($apiUrl);
// 配置请求头，按照接口要求加，比如认证、Content-Type之类的
$headers = [
    'Authorization: Bearer your_token_here',
    'Accept: application/zip'
];
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
// 不直接输出响应，返回给变量
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// 明确指定接收二进制内容，不做编码转换
curl_setopt($ch, CURLOPT_BINARYTRANSFER, true);
// 自动处理gzip等压缩的响应，避免拿到压缩后的乱码内容
curl_setopt($ch, CURLOPT_ENCODING, '');
// 超时时间设置，根据实际需求调整
curl_setopt($ch, CURLOPT_TIMEOUT, 60);

// 执行请求拿到原始二进制响应
$zipContent = curl_exec($ch);

// 检查请求是否出错
if(curl_errno($ch)){
    $error = curl_error($ch);
    curl_close($ch);
    die("请求失败：" . $error);
}

// 检查HTTP状态码，非200说明接口返回异常
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if($httpCode !== 200){
    curl_close($ch);
    die("接口返回异常，状态码：" . $httpCode);
}
curl_close($ch);

// 将二进制内容写入文件
$writeResult = file_put_contents($savePath, $zipContent);
if($writeResult === false){
    die("文件写入失败，请检查目录权限");
}

echo "ZIP文件保存成功，路径：" . $savePath;
?>

方案2：file_get_contents实现（写法简单） #

适合简单的GET请求场景，不需要额外扩展：

<?php
$apiUrl = 'https://third-party-api.com/endpoint/get-zip';
$savePath = '/your/server/path/target.zip';

// 配置请求上下文，按照接口要求加参数，比如POST、请求头之类的
$context = stream_context_create([
    'http' => [
        'method' => 'GET',
        'header' => "Authorization: Bearer your_token_here\r\nAccept: application/zip\r\n",
        // 忽略错误，方便自行判断状态码
        'ignore_errors' => true,
        'timeout' => 60
    ]
]);

// 拿到原始响应内容
$zipContent = file_get_contents($apiUrl, false, $context);

// 检查请求结果
if($zipContent === false){
    die("请求接口失败");
}

// 写入文件
if(file_put_contents($savePath, $zipContent) === false){
    die("文件写入失败，请检查目录权限");
}

echo "ZIP文件保存成功";
?>

常见问题排查 #

• 保存后的ZIP文件损坏无法打开：首先打印响应前100个字符，确认是否是接口返回了错误信息（比如认证失败的JSON文本），而非实际的ZIP二进制内容；如果确认返回的是二进制，检查是否开启了自动解压gzip的配置。
• 文件写入失败：确认存储目录的权限配置，PHP运行用户（一般是www-data、apache）需要有对应目录的写入权限。
• 不要对响应内容做任何编码处理，比如utf8_encode、htmlspecialchars这类函数会破坏二进制文件结构。

内容的提问来源于stack exchange，提问作者Maurya