PHP用cURL调用第三方RESTful API，这件事说难不难，说简单也容易踩坑。关键不在于写得多，而在于每一步都踩准——尤其容易漏掉CURLOPT_RETURNTRANSFER或Content-Type头，导致返回为空或接口直接拒绝。其实，只要把初始化、请求配置、响应处理和资源释放这四个环节理清楚，大部分问题都能迎刃而解。
基础GET请求：拿到数据的第一步
这个场景最常见，适用于公开接口或带简单Token认证的情况。操作上并不复杂，但有几个细节必须注意：
- 先调用
curl_init()创建句柄，别跳过这步，很多人上来就写curl_setopt，结果连句柄都没创建。 - 必须设置
CURLOPT_RETURNTRANSFER => true，否则curl_exec()不会返回内容，而是直接输出到页面，变量里什么也拿不到。 - 加个
CURLOPT_TIMEOUT => 10防止卡死，本地调试时可以设短一些，比如5秒。 - 如果需要认证，在
CURLOPT_HTTPHEADER里加上'Authorization: Bearer xxx'或'X-API-Key: your-key'，别漏了。 - 执行后一定要检查
curl_errno($ch)是否为0，再看HTTP状态码是否为200，缺一不可。
POST提交JSON数据：别只传body不设头
很多REST接口对请求头的要求非常严格，尤其是Content-Type: application/json。光用json_encode()转成字符串是不够的，如果头没设对，后端根本无法解析body。
- 数据先用
json_encode($data)转成字符串，别直接传数组过去，否则cURL会当成表单数据来处理。 CURLOPT_POST => true或CURLOPT_CUSTOMREQUEST => 'POST'二选一即可，别同时写。CURLOPT_POSTFIELDS填的是JSON字符串，不是数组。CURLOPT_HTTPHEADER必须包含'Content-Type: application/json'，否则后端可能解析失败，返回空或错误。- 如果接口返回错误，先打印原始
$response，确认是不是JSON格式问题，别急着改代码。
错误排查：空响应、false、0？先看这三处
不是代码写错了，往往是配置缺项。遇到问题时，先别怀疑人生，检查这三处：
CURLOPT_RETURNTRANSFER没设true → 返回false或直接输出，变量里自然没有内容。- HTTPS请求时
CURLOPT_SSL_VERIFYPEER为true但证书无效 → 开发环境可以临时设false，上线必须恢复并配好CA证书。 - DNS解析失败或连接超时 → 检查
CURLOPT_CONNECTTIMEOUT是否太小，建议3~5秒，同时确认域名能ping通。 - 响应太大被截断 → 确认没有误设
CURLOPT_HEADER或CURLOPT_NOBODY。 - 用
curl_error($ch)和curl_getinfo($ch)组合查具体原因，比猜快得多，也靠谱得多。
响应处理：JSON别硬解，先验再用
返回内容不一定是有效JSON，尤其出错时接口可能返回HTML或纯文本。所以拿到响应后，别急着用：
- 用
json_decode($response, true)转成关联数组，便于后续取值。 - 调用后立刻检查
json_last_error() === JSON_ERROR_NONE，否则用json_last_error_msg()看具体报什么错。 - 如果
$response是空字符串或null，先确认cURL是否执行成功，再查API文档是否要求特定参数或路径。 - 敏感字段（如token、密码）别打日志，响应里如果包含用户数据，要过滤后再展示。
