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。
立即学习“PHP免费学习笔记（深入）”；
- 发 PUT/DELETE/PATCH 时，
CURLOPT_POST必须为false（或干脆不设） - 请求体一律走
CURLOPT_POSTFIELDS，无论方法是什么 —— cURL 不关心方法语义，只管把内容塞进 body - 某些旧版 PHP 扩展（如 php-curl 7.2 以下）对空 body 的 PUT 处理异常，建议始终传空字符串：
curl_setopt($ch, CURLOPT_POSTFIELDS, "")
curl_exec() 返回空字符串，但很多人误判为“请求失败”而重试，其实应检查 curl_getinfo($ch, CURLINFO_HTTP_CODE) 判定状态码而非响应体长度。 
