php用curl调用api最稳写法需设超时、处理ssl、检查http状态码；post json须json_encode+设置content-type头；高频调用推荐guzzle并复用client；开发api可用slim框架统一错误格式。
PHP用cURL调用API接口最稳的写法
直接上手就出错，多数是因为没设超时、没处理SSL或忽略了HTTP状态码。PHP自带的cURL是调用外部API最可靠的方式，比file_get_contents可控得多。
关键点不是“能不能发”，而是“发完怎么确认它真成功了”：
-
curl_setopt($ch, CURLOPT_TIMEOUT, 10)必须设，否则卡死无感知 -
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true)不加就直接输出，没法解析 - 对接HTTPS接口时，
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false)仅限测试；生产环境要用CURLOPT_CAINFO指定证书路径 - 务必检查
curl_getinfo($ch, CURLINFO_HTTP_CODE)，200不等于业务成功，4xx/5xx要单独处理
POST JSON数据到API的三个易错细节
很多PHP新手用http_build_query()拼JSON，结果API收不到——那是表单格式，不是JSON。
正确姿势是手动json_encode() + 设置Header：
立即学习“PHP免费学习笔记（深入）”；
- 先
$data = json_encode(['name' => 'Alice', 'age' => 25]) - 再
curl_setopt($ch, CURLOPT_POSTFIELDS, $data) - 必须加Header：
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']) - 别漏掉
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST')，尤其当复用GET配置时
用Guzzle简化重复调用但别滥用
如果你项目里有5个以上API要调，硬写cURL会重复造轮子。Guzzle是事实标准，但要注意它不是“万能胶”：
- 安装用
composer require guzzlehttp/guzzle，别手动下载 - 基础调用简洁：
$client->post('https://api.example.com/users', ['json' => $payload])，自动序列化+设Header - 别在循环里反复
new Client()，应复用实例；连接池和重试策略得显式配置，否则默认不重试 - 错误捕获必须用
try/catch GuzzleException，$e->getResponse()才能拿到真实响应体
开发自己的API接口：Slim框架够轻又不裸奔
不用Laravel也能写出健壮API。Slim 4是当前最平衡的选择——比原生$_GET/$_POST多一层路由和中间件，又比全栈框架少一堆冗余。
起步只需三步：
- 装
composer require slim/slim:"4.*" - 路由定义清晰：
$app->get('/users/{id}', function ($request) { ... })，参数自动注入 - 返回JSON别手拼：
return $response->withJson(['data' => $user], 200)，自动设Header和状态码 - 加
slim/psr7和php-di/php-di可支持依赖注入，但小项目不强求
真正容易被忽略的是错误响应格式统一——哪怕只返回{"error": "xxx"}，也要所有接口保持结构一致，前端才不会反复适配。
