laravel 官方推荐使用内置的 http 客户端（http facade）发起外部 api 请求，它简洁、安全、可测试，并原生支持重试、超时、认证、请求/响应日志等高级功能。
laravel 官方推荐使用内置的 http 客户端（http facade）发起外部 api 请求，它简洁、安全、可测试，并原生支持重试、超时、认证、请求/响应日志等高级功能。
Laravel 自 7.x 起内置了功能强大的 Illuminate\Support\Facades\Http（即 HTTP Facade），取代了第三方库（如 Guzzle 手动封装）成为调用外部 API 的首选方案。它基于 Guzzle 构建，但提供了更优雅、更符合 Laravel 风格的 API 封装。
✅ 基础用法示例
use Illuminate\Support\Facades\Http;
// GET 请求（返回 JSON 自动解码为数组）
$response = Http::get('https://jsonplaceholder.typicode.com/posts/1');
if ($response->successful()) {
$post = $response->json(); // 自动解析 JSON
echo $post['title'];
}
// POST 请求（自动序列化为 JSON）
$response = Http::post('https://httpbin.org/post', [
'name' => 'Laravel',
'version' => '10.x'
]);
echo $response->body(); // 原始响应体? 进阶特性推荐
-
超时与重试：避免因网络波动导致请求失败
Http::timeout(5) ->retry(3, 100) // 失败后重试 3 次，间隔 100ms ->get('https://api.example.com/data'); -
认证与 Header 设置
Http::withToken('your-api-key') ->withHeaders(['X-Client-ID' => 'my-app']) ->get('https://api.service.com/users'); -
错误处理与日志
try { $response = Http::timeout(10)->get('https://api.example.com'); $response->throw(); // 抛出 4xx/5xx 异常 } catch (\Illuminate\Http\Client\ConnectionException $e) { \Log::error('API connection failed: ' . $e->getMessage()); } catch (\Illuminate\Http\Client\RequestException $e) { \Log::error('API request failed: ' . $e->getMessage()); }
⚠️ 注意事项
- ❌ 不要直接在控制器中硬编码 HTTP 调用——应封装为 Service 类（如 ApiService），便于复用、测试与维护；
- ✅ 使用 Http::fake() 在测试中模拟响应，无需真实网络请求；
- ? 生产环境建议配置连接池、限流及熔断机制（可通过自定义中间件或集成 Laravel Octane + Swoole 实现）；
- ? 敏感凭证（如 API Key）务必通过 .env 配置并使用 config() 或 env() 安全读取，切勿硬编码。
综上，Laravel HTTP 客户端不仅是“可用”的方案，更是 Laravel 生态中最符合约定、最易维护、最利于测试的官方标准方式。从简单 GET 到复杂微服务通信，它都能提供一致、可靠、可扩展的抽象层。
