如何在PHP中通过CURL下载二进制数据并解决文件损坏问题？

我帮你排查了代码里的问题，主要有几个关键错误导致下载的DOCX文件损坏，下面一步步说清楚问题和修复方案：

问题分析 #

你的代码里有两个核心问题直接破坏了二进制文件的完整性：

1. 响应头与正文的分割符错误：HTTP协议规定响应头和正文的分隔是\r\n\r\n（两个连续的回车换行），但你用了\n\r来分割，这会导致分割后的正文可能包含部分头内容，或者漏掉正文的开头部分。
2. 错误截断正文内容：你用substr($file_array[1], 1)切掉了正文的第一个字节，而DOCX本质是ZIP压缩包，开头必须是PK标识，切掉第一个字节直接破坏了文件结构。

另外还有个小细节：CURLOPT_BINARYTRANSFER在PHP 5.1.3之后已经被废弃了，CURLOPT_RETURNTRANSFER已经会正确返回二进制数据，这个参数可以去掉。

修复步骤 #

1. 修正头与正文的分割逻辑 #

把分割代码从：

$file_array = explode("\n\r", $file, 2);

改成符合HTTP标准的分割方式：

$file_array = explode("\r\n\r\n", $file, 2);

如果担心某些服务器的换行格式不一致，也可以用更鲁棒的定位方式：

$separator = "\r\n\r\n";
$pos = strpos($file, $separator);
$header_part = substr($file, 0, $pos);
$body_part = substr($file, $pos + strlen($separator));

2. 移除不必要的正文截断 #

直接输出完整的正文内容，把：

echo substr($file_array[1], 1);

改成：

echo $file_array[1];
// 或者用上面鲁棒方式的变量
echo $body_part;

3. 可选：改用更可靠的响应头获取方式 #

手动解析响应头容易出错，你可以关闭CURLOPT_HEADER，改用curl_getinfo直接获取Content-Type，代码会更简洁：

curl_setopt($resource, CURLOPT_HEADER, 0); // 不返回响应头
// ...执行curl_exec后
$content_type = curl_getinfo($resource, CURLINFO_CONTENT_TYPE);
header('Content-type: ' . $content_type);

完整修复后的代码示例 #

$url = "some api URL. It is not a file URL.";
$resource = curl_init();
curl_setopt($resource, CURLOPT_SSL_VERIFYPEER, 0); // 注意：生产环境建议开启证书验证，提升安全性
curl_setopt($resource, CURLOPT_URL, $url);
curl_setopt($resource, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($resource, CURLOPT_HTTPHEADER, array("Authorization: OAuth $access_token"));

$response = curl_exec($resource);
$content_type = curl_getinfo($resource, CURLINFO_CONTENT_TYPE);
curl_close($resource);

// 输出下载头
header('Content-type: ' . $content_type);
header("Content-disposition: attachment; filename=thiisit.docx");
// 确保没有多余输出，直接输出完整的二进制响应正文
echo $response;
die;

这个版本的代码去掉了手动解析响应头的步骤，避免了分割错误，同时保证了二进制数据的完整性。另外还要注意：如果你的PHP文件开头有空白行或者其他意外输出（比如调试用的echo、var_dump），会导致响应中混入额外字符，破坏文件，一定要确保输出下载内容之前没有任何多余的输出。

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