curl_init()后必须调用curl_setopt()设置curlopt_returntransfer为true，否则响应内容直接输出而非返回；php 8.5要求curl_setopt_array()键名全小写或用常量，且需同时设置curlopt_connecttimeout和curlopt_timeout。
curl_init() 之后必须调用 curl_setopt() 设置 CURLOPT_RETURNTRANSFER
PHP 8.5 中 curl 扩展行为没变，但新手常卡在返回空或直接输出响应体。根本原因是没设 CURLOPT_RETURNTRANSFER —— 默认值是 false，cURL 会直接把响应内容 echo 出来，而不是返回字符串。
常见错误现象：curl_exec() 返回 true 或 null，但看不到响应数据；浏览器页面顶部突然冒出一串 JSON 或 HTML。
- 务必在
curl_exec()前设置：curl_setopt($ch, CURLOPT_RETURNTRANSFER, true) - 如果还要获取响应头，加
curl_setopt($ch, CURLOPT_HEADER, true)，但注意此时响应体和头混在一起，需手动分割 - PHP 8.5 不再支持
CURLOPT_SSL_VERIFYPEER = false的“静默降级”，设为false会抛CurlException，应改用CURLOPT_CAINFO指向证书路径
PHP 8.5 下 curl_setopt_array() 的键名必须全小写
PHP 8.5 对 cURL 选项键名做了更严格的校验。虽然旧版容忍 CURLOPT_URL、CURLOPT_TIMEOUT 这类大写形式，但 8.5 开始只认小写键（如 curlopt_url），否则整个 curl_setopt_array() 失效，且不报错，容易误判为网络问题。
使用场景：批量配置请求参数时想省几行代码，结果请求发不出去。
立即学习“PHP免费学习笔记（深入）”；
- 正确写法：
['curlopt_url' => 'https://api.example.com', 'curlopt_timeout' => 10] - 错误写法：
['CURLOPT_URL' => '...', 'CURLOPT_TIMEOUT' => 10]—— 在 PHP 8.5 中被忽略 - 建议统一用常量替代字符串键名，避免拼写/大小写问题：
[CURLOPT_URL => '...', CURLOPT_TIMEOUT => 10]
超时控制必须同时设 curlopt_timeout 和 curlopt_connecttimeout
只设 curlopt_timeout 不够。PHP 8.5 的 cURL 绑定的是较新 libcurl，默认 DNS 解析、TCP 握手、TLS 握手都算进总超时，但实际中经常卡在连接阶段（比如目标域名解析慢、端口不通），导致 curlopt_timeout 还没触发就 hang 住。
性能影响：未设连接超时的请求，在 DNS 故障或防火墙拦截时可能阻塞 60+ 秒（取决于系统默认 resolve timeout）。
-
curlopt_connecttimeout控制“建立 TCP 连接”的最大耗时，建议设为 3–5 秒 -
curlopt_timeout控制“整个请求周期”（含连接 + 发送 + 接收），建议设为连接超时的 2–3 倍 - 别用
set_time_limit()替代——它无法中断底层 cURL 阻塞调用
POST 请求传 JSON 必须手动设 curlopt_httpheader 和 curlopt_POSTFIELDS
很多人以为 curlopt_post 设为 true 就能发 JSON，其实那只是启用 POST 方法，不指定 Content-Type 和 body 格式，服务端大概率当 application/x-www-form-urlencoded 解析，导致 $_POST 为空、file_get_contents('php://input') 也读不到原始 JSON。
常见错误现象：接口返回 400，日志显示 “invalid json” 或 “missing required field”。
- 必须显式设置 header：
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']) -
curlopt_POSTFIELDS要传字符串，不是数组：json_encode(['name' => 'foo']) - 如果传数组，cURL 会自动转成
key=val&key2=val2格式，彻底破坏 JSON 结构
