PHP脚本调用API的实用经验分享

最近在做公司的一个小项目，需要把用户提交的订单信息自动同步到第三方仓储系统。最直接的办法就是用 PHP 脚本去调用对方提供的 API。刚开始折腾了几天，踩了些坑，现在回过头看其实也没那么复杂。

准备工作：了解 API 文档

每个 API 都有自己的规则，比如请求方式（GET 还是 POST）、是否需要认证、参数怎么传。我对接的那个接口要求用 POST 提交 JSON 数据，还得带上 token 做身份验证。所以第一步不是写代码，而是老老实实看完对方给的文档。

用 cURL 发起请求最常见

PHP 里调用 API 最常用的还是 cURL。下面是个简单的例子，向某个地址提交用户数据：

$url = 'https://api.example.com/order';
$data = [
    'name' => '张三',
    'phone' => '13800138000',
    'product' => '无线鼠标'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer your-token-here'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);

if (curl_error($ch)) {
    echo '请求出错：' . curl_error($ch);
} else {
    echo '返回结果：' . $response;
}

curl_close($ch);

这段代码跑通之后，我就把它封装成一个函数，以后哪里要用直接调就行，省得重复写。

处理返回结果别大意

API 返回的数据通常是 JSON 格式，记得用 json_decode() 解析。有时候网络抖动或者服务器忙，可能返回空值或错误信息，加个判断更稳妥：

$result = json_decode($response, true);

if (isset($result['status']) && $result['status'] === 'success') {
    echo '订单同步成功';
} else {
    error_log('API 调用失败：' . $response);
}

定时任务交给 cron 来跑

有些数据不需要实时推送，比如每天凌晨把前一天的订单汇总发一次。这时候可以把 PHP 脚本丢到服务器上，用 Linux 的 cron 定时执行：

0 2 * * * /usr/bin/php /var/www/html/sync_orders.php

这行配置的意思是每天凌晨两点自动运行脚本，不用人工干预。

调试时打开日志很关键

线上环境出问题最难查，建议每次调用 API 都记下时间、请求内容和返回结果，写进日志文件。哪天数据对不上，翻日志一眼就能定位。

其实 PHP 调用 API 并不难，关键是细心。参数传错了、头信息少写了、网络超时没处理，都可能导致失败。多试几次，慢慢就熟了。