当前位置：首页 > 文章列表 > 文章 > php教程 > PHP调用API接口代码示例

PHP调用API接口代码示例

2026-04-09 13:18:28 0浏览收藏

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

php代码示例如何调用api接口_php调用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);
<p>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');
}</p><pre class="brush:

;toolbar:false;">

用 `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);
```