PHP用cURL发PUT/DELETE/PATCH等非GET/POST请求必须设CURLOPT_CUSTOMREQUEST，禁用CURLOPT_POST；下载二进制文件需启用CURLOPT_BINARYTRANSFER和CURLOPT_RETURNTRANSFER；远程连接失败优先排查网络层而非PHP配置。

PHP 用 cURL 发起非 GET/POST 请求（如 PUT、DELETE、PATCH）

PHP 默认的 file_get_contents() 只支持 GET 和 POST（且需额外配置），要发自定义 HTTP 方法（比如 PUT、DELETE、PATCH），必须用 curl_setopt() 显式设置 CURLOPT_CUSTOMREQUEST，不能只靠 CURLOPT_POST 或 CURLOPT_POSTFIELDS 混淆处理。

• CURLOPT_CUSTOMREQUEST 是唯一可靠方式 —— 它直接覆盖请求行中的方法名，比如设为 "PUT"，cURL 就真发 PUT /path HTTP/1.1
• 别误用 CURLOPT_HTTPGET = true 配合 CURLOPT_CUSTOMREQUEST，这会冲突导致方法被重置为 GET
• 如果带请求体（如 JSON），记得同时设 CURLOPT_POSTFIELDS；空方法（如无 body 的 DELETE）可留空，但 CURLOPT_CUSTOMREQUEST 仍必须显式指定

curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PATCH");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['status' => 'active']));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);

远程文件读取失败时，cURL 报 “Failed to connect to xxx” 怎么排查

这不是权限或路径问题，而是网络层未通。常见于目标服务未监听、防火墙拦截、DNS 解析失败，或 PHP 运行环境（如 Docker 容器、云函数）根本没外网出口。

• 先在服务器终端执行 curl -v https://example.com/file.txt，确认系统级能通 —— 如果也失败，说明不是 PHP 问题
• 检查 CURLOPT_TIMEOUT 是否太小（默认 0＝无限等待），建议设为 30 防卡死
• 若目标是 HTTPS，而服务器没装 CA 证书包，会报 SSL certificate problem；临时方案是加 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false)（仅测试用，生产禁用）
• Docker 或某些托管环境（如腾讯云 SCF）默认禁用 outbound 网络，需查平台文档开白名单或换运行环境

用 cURL 下载远程二进制文件（图片、PDF）怎么避免乱码或损坏

核心是关闭输出缓冲、禁用自动解码，并确保 CURLOPT_RETURNTRANSFER 开启后原样接收字节流 —— 任何中间字符串操作（如 trim()、json_decode()）都会破坏二进制数据。

• 务必设 CURLOPT_BINARYTRANSFER => true（PHP 5.1.3+，虽默认开启，但显式写明更稳妥）
• 不要用 file_get_contents() 直接读远程 URL，它可能触发 allow_url_fopen 限制，且不支持自定义 method 或 header
• 写入本地文件前，用 file_put_contents($path, $data, LOCK_EX) 加锁，防止并发写花
• 下载后可用 getimagesize($path) 或 finfo_file(finfo_open(FILEINFO_MIME_TYPE), $path) 校验 MIME 类型是否符合预期

$ch = curl_init('https://cdn.example.com/photo.jpg');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_BINARYTRANSFER, true);
$data = curl_exec($ch);
if ($data !== false) {
    file_put_contents('/tmp/photo.jpg', $data, LOCK_EX);
}

为什么 setopt(CURLOPT_POST, true) + setopt(CURLOPT_POSTFIELDS, ...) 不能发 PUT

因为 CURLOPT_POST 是布尔开关，它只告诉 cURL “按 POST 方式构造请求”，底层仍会强制用 POST 方法名，和 CURLOPT_CUSTOMREQUEST 冲突。哪怕你同时设了 CURLOPT_CUSTOMREQUEST => "PUT"，只要 CURLOPT_POST 为 true，最终发出的仍是 POST。

• 发 PUT/DELETE/PATCH 时，CURLOPT_POST 必须为 false（或干脆不设）
• 请求体一律走 CURLOPT_POSTFIELDS，无论方法是什么 —— cURL 不关心方法语义，只管把内容塞进 body
• 某些旧版 PHP 扩展（如 php-curl 7.2 以下）对空 body 的 PUT 处理异常，建议始终传空字符串：curl_setopt($ch, CURLOPT_POSTFIELDS, "")