Laravel的HTTP客户端怎么用_Laravel HTTP Client发起API请求教程

在 Laravel 7 及以上版本中，Laravel 提供了一个简洁、强大的 HTTP 客户端——GuzzleHttp 的轻量级封装，让你可以轻松发起外部 API 请求。你不需要直接安装 Guzzle，Laravel 已经内置了对它的支持（只需安装 guzzlehttp/guzzle 包即可）。

1. 安装 Guzzle

Laravel 的 HTTP 客户端基于 Guzzle，所以需要先安装它：

composer require guzzlehttp/guzzle

安装完成后就可以使用 Illuminate\Support\Facades\Http 来发起请求。

2. 发起基本的 GET 请求

使用 Http::get() 方法可以轻松获取外部接口数据：

• Http::get('https://api.example.com/users')
• 获取响应内容：Http::get('...')->body()
• 解析为数组：Http::get('...')->json()
• 判断请求是否成功：Http::get('...')->successful()

示例：

$response = Http::get('https://jsonplaceholder.typicode.com/posts/1');

if ($response->successful()) {
    $data = $response->json(); // 转为数组
    echo $data['title'];
}

3. 发送带参数的 GET 请求

传入第二个参数作为查询字符串：

$response = Http::get('https://api.example.com/search', [
    'q' => 'laravel',
    'limit' => 10
]);

// 请求实际访问：/search?q=laravel&limit=10

4. 发起 POST 请求

使用 Http::post() 发送数据：

$response = Http::post('https://api.example.com/users', [
    'name' => 'John Doe',
    'email' => 'john@example.com'
]);

// 获取返回结果
$user = $response->json();

支持发送 JSON、表单数据等格式，默认发送的是 JSON。

5. 设置请求头

使用 withHeaders() 添加自定义请求头：

$response = Http::withHeaders([
    'X-API-TOKEN' => 'your-token',
    'Content-Type' => 'application/json',
])->post('https://api.example.com/data', [
    'title' => 'Test'
]);

6. 添加认证信息

支持 Bearer Token 和 Basic 认证：

• Bearer Token：Http::withToken('access_token')
• Basic 认证：Http::withBasicAuth('username', 'password')

例如：

$response = Http::withToken('eyJ...')->get('https://api.example.com/profile');

7. 设置超时和重试机制

控制请求行为：

• 设置超时时间（秒）：Http::timeout(10)
• 连接超时：Http::connectTimeout(5)
• 失败后自动重试：Http::retry(3, 100)（重试3次，每次间隔100ms）

组合使用：

$response = Http::timeout(5)
    ->retry(2, 100)
    ->post('https://api.example.com/submit', $data);

8. 处理错误响应

可以使用 throw() 自动抛出客户端或服务端错误（4xx 或 5xx）：

$response = Http::get('https://api.example.com/bad-endpoint');
$response->throw(); // 如果失败会抛出异常

// 或链式调用
$data = Http::get('...')->throw()->json();

也可以手动检查状态码：

if ($response->status() === 404) {
    // 处理未找到
}

9. 发送表单数据（x-www-form-urlencoded）

默认是 JSON，如果要发送表单数据，使用 asForm()：

$response = Http::asForm()->post('https://api.example.com/login', [
    'email' => 'user@example.com',
    'password' => 'secret'
]);

10. 上传文件（Multipart 请求）

使用 attach() 上传文件：

$response = Http::attach(
    'attachment', file_get_contents('photo.jpg'), 'photo.jpg'
)->post('https://api.example.com/upload');

也可以传文件路径：

Http::attach('file', fopen('path/to/photo.jpg', 'r'))

小技巧：创建客户端实例复用配置

如果你多次请求同一个服务，可以用 withHeaders + 变量保存配置：

$client = Http::withToken('x')->timeout(5);

$client->get('https://api.example.com/user');
$client->post('https://api.example.com/posts', $data);

基本上就这些。Laravel 的 HTTP 客户端设计得非常直观，适合快速集成第三方 API，代码清晰又安全。