PHP调用API接口代码示例

本文深入解析了PHP调用API接口最稳妥、生产可用的实践方案——聚焦cURL的正确使用，强调必须设置超时、强制开启SSL证书验证（而非禁用）、严格检查cURL错误与HTTP状态码，并区分GET/POST（尤其是JSON格式）的完整代码示例；同时直击开发中高频痛点，如SSL证书错误（cURL error 60）的根因与安全修复方案，彻底告别“能跑通就行”的侥幸心理，助你写出高健壮、易维护、可上线的API调用代码。

PHP 调用 API 接口最稳妥的方式是用 curl，而不是 file_get_contents 或 stream_context_create —— 后两者在 HTTPS、超时、错误处理上容易出问题。

用 curl 发送 GET 请求并处理 JSON 响应

这是最常见场景：请求第三方 API（如天气、短链、支付回调验证），拿到 JSON 数据后 json_decode 解析。

关键点在于显式设置超时、SSL 验证和错误检查：

• curl_setopt($ch, CURLOPT_TIMEOUT, 10) 必须设，否则默认永不超时，可能卡死进程
• curl_setopt($ch, CURLOPT_RETURNTRANSFER, true) 必须设，否则直接输出而非返回字符串
• curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false) 仅开发调试时临时关闭；生产环境必须保持 true 并确保系统有 CA 证书（如 CentOS 的 /etc/pki/tls/certs/ca-bundle.crt）
• 调用后务必检查 curl_error($ch) 和 HTTP 状态码，200 不等于业务成功，API 可能返回 {"code":401,"msg":"token expired"}

```php
$ch = curl_init('https://api.example.com/v1/user?id=123');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true); // 生产环境不要关
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error = curl_error($ch);
curl_close($ch);
if ($error || $httpCode !== 200) {
throw new Exception("API request failed: {$error}, HTTP {$httpCode}");
}
$data = json_decode($response, true);
if (json_last_error() !== JSON_ERROR_NONE) {
throw new Exception('Invalid JSON response');
}

用 curl 发送 POST 请求（JSON 格式）
向 RESTful API 提交数据时，多数要求 Content-Type: application/json，且请求体是原始 JSON 字符串，不是 application/x-www-form-urlencoded。
常见错误是误用 curl_setopt($ch, CURLOPT_POSTFIELDS, $arr) 直接传数组 —— 这会自动变成表单编码，服务端收不到 json_decode(file_get_contents('php://input'))。

先用 json_encode($data) 序列化数组为字符串
手动设置 Content-Type header：curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json'])
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonString) 传字符串，不是数组
如果 API 要求带 token，加到 header：['Authorization: Bearer abc123', 'Content-Type: application/json']

```php
$data = ['name' => 'Alice', 'email' => 'a@example.com'];
$jsonString = json_encode($data);

$ch = curl_init('https://api.example.com/v1/users');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonString);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$response = curl_exec($ch);
curl_close($ch);
```

遇到 cURL error 60 或 SSL certificate problem 怎么办
这是 Windows 或旧版 PHP（尤其 WAMP/XAMPP）常见问题，本质是 cURL 找不到 CA 证书路径。

先确认是否真要绕过 SSL：curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false) 是临时方案，不能上线
正确做法是下载最新 CA 包（如 https://curl.se/ca/cacert.pem），保存为 cacert.pem
在 php.ini 中设置：curl.cainfo = "/path/to/cacert.pem"（Windows 用反斜杠或双正斜杠）
或运行时指定：curl_setopt($ch, CURLOPT_CAINFO, '/var/www/cacert.pem')
Linux 系统通常已内置，但 Docker 容器里可能缺失，需在镜像中 apt-get install ca-certificates


别只盯着“能跑通”，API 调用的健壮性藏在超时控制、SSL 验证、HTTP 状态码判断、JSON 解析容错这些细节里。漏掉任意一项，上线后都可能变成深夜告警。
终于介绍完啦！小伙伴们，这篇关于《PHP调用API接口代码示例》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！