PHP调用外部API常用三种方法：一、cURL（最灵活，支持认证与超时）；二、file_get_contents配合stream_context_create（轻量，适合简单GET）；三、Guzzle库（功能强，支持异步与中间件）。
如果您需要在PHP项目中获取第三方服务的数据，通常需要通过HTTP请求调用其公开的API接口。以下是几种常用且可直接运行的PHP调用外部API的方法：
一、使用cURL发送GET请求
cURL是PHP中最常用、最灵活的HTTP客户端扩展，支持多种协议和认证方式，适用于大多数API调用场景。
1、确保PHP环境已启用curl扩展，可通过phpinfo()或执行extension_loaded('curl')验证。
2、初始化cURL会话：$ch = curl_init();
立即学习“PHP免费学习笔记（深入）”；
3、设置目标URL与基础选项：curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/data');
4、配置返回结果为字符串而非直接输出：curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
5、可选：设置超时时间防止阻塞：curl_setopt($ch, CURLOPT_TIMEOUT, 10);
6、执行请求并捕获响应：$response = curl_exec($ch);
7、检查是否发生错误：if (curl_errno($ch)) { echo 'cURL Error: ' . curl_error($ch); }
8、关闭cURL句柄：curl_close($ch);
9、解析JSON响应（如适用）：$data = json_decode($response, true);
二、使用file_get_contents配合stream_context_create
该方法无需额外扩展，适合简单GET请求，通过自定义流上下文传递HTTP头信息或POST数据。
1、构建请求头数组，例如包含Authorization或Content-Type：$headers = ['Content-Type: application/json'];
2、将头信息格式化为字符串：$header_str = implode("\r\n", $headers);
3、创建流上下文选项：$context = stream_context_create(['http' => ['method' => 'GET', 'header' => $header_str, 'timeout' => 10]]);
4、发起请求：$response = file_get_contents('https://api.example.com/data', false, $context);
5、判断请求是否成功：if ($response === false) { echo '请求失败'; }
6、解析返回内容：$data = json_decode($response, true);
三、使用Guzzle HTTP客户端库
Guzzle是一个功能完备的PHP HTTP客户端，提供链式调用、中间件支持及异步请求能力，适合中大型项目集成。
1、通过Composer安装：composer require guzzlehttp/guzzle
2、引入自动加载文件：require 'vendor/autoload.php';
3、实例化客户端：$client = new \GuzzleHttp\Client();
4、发起GET请求：$response = $client->request('GET', 'https://api.example.com/data');
5、获取响应体：$body = $response->getBody()->getContents();
6、处理状态码：if ($response->getStatusCode() !== 200) { echo 'API返回非200状态'; }
7、解析JSON数据：$data = json_decode($body, true);
四、发送带Bearer Token的认证请求
许多API要求在请求头中携带Authorization: Bearer
1、准备有效的访问令牌：必须确保token未过期且具备对应接口权限
2、构造认证头：$auth_header = 'Authorization: Bearer ' . $token;
3、在cURL配置中加入头信息：curl_setopt($ch, CURLOPT_HTTPHEADER, [$auth_header, 'Content-Type: application/json']);
4、若token存储在环境变量中，应使用getenv('API_TOKEN')安全读取，禁止硬编码在源码中
5、发起请求后，检查响应头中的X-RateLimit-Remaining等字段判断配额余量
五、处理API返回的错误响应
真实调用中常遇到4xx/5xx状态码、空响应或JSON解析失败等情况，需统一拦截并提取有效错误信息。
1、对cURL响应，使用curl_getinfo($ch, CURLINFO_HTTP_CODE)获取实际HTTP状态码
2、当状态码为401时，表明认证失败，请检查token有效性或刷新机制
3、当状态码为404时，确认请求URL路径拼写及版本号是否正确
4、尝试json_decode($response, true)后检查是否返回null，若是则用json_last_error_msg()定位JSON格式问题
5、记录原始响应体用于调试：error_log('API Response: ' . print_r($response, true));
