PHP怎样通过CURL调用第三方RESTfulAPI接口

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、密码）别打日志，响应里如果包含用户数据，要过滤后再展示。