在Laravel框架中，开发者可以通过内置的HTTP客户端辅助函数快速完成各类HTTP请求操作，无需手动编写复杂的curl代码，大幅降低请求处理的复杂度。这些辅助函数对底层Guzzle客户端做了封装，提供了更简洁的调用方式，适配大多数业务场景的请求需求。
Laravel内置HTTP客户端基础用法
Laravel的HTTP客户端通过IlluminateSupportFacadesHttp门面提供调用入口，首先需要在文件中引入该门面，之后就可以使用对应的辅助方法发送请求。
发送GET请求
发送GET请求可以直接调用Http::get()方法，第一个参数为请求地址，第二个可选参数为查询参数数组。
<?php
use IlluminateSupportFacadesHttp;
// 发送不带参数的GET请求
$response = Http::get('https://ipipp.com/api/user/list');
// 获取响应状态码
$statusCode = $response->status();
// 获取响应内容，自动解析json为数组
$data = $response->json();
// 发送带查询参数的GET请求
$response2 = Http::get('https://ipipp.com/api/user/detail', [
'user_id' => 1001,
'type' => 'normal'
]);
<?php
发送POST请求
POST请求可以使用Http::post()方法，第二个参数为请求体数据，支持表单数据、json数据等格式。
<?php
use IlluminateSupportFacadesHttp;
// 发送表单格式的POST请求
$response = Http::post('https://ipipp.com/api/user/create', [
'username' => 'test_user',
'password' => '123456',
'email' => 'test@ipipp.com'
]);
// 发送json格式的POST请求，使用asJson方法指定
$response2 = Http::asJson()->post('https://ipipp.com/api/order/create', [
'order_id' => '202401001',
'amount' => 99.9,
'goods' => ['book', 'pen']
]);
<?php
请求配置与高级用法
除了基础的请求方法，Laravel的HTTP客户端还支持多种配置项，满足更复杂的请求场景需求。
设置请求头
可以通过withHeaders()方法添加自定义请求头，常用于传递认证信息、指定内容类型等场景。
<?php
use IlluminateSupportFacadesHttp;
$response = Http::withHeaders([
'Authorization' => 'Bearer token_abc123',
'Accept' => 'application/json',
'X-Request-From' => 'laravel_client'
])->get('https://ipipp.com/api/private/data');
<?php
超时与重试配置
可以通过timeout()设置请求超时时间，通过retry()设置请求失败后的重试策略。
<?php
use IlluminateSupportFacadesHttp;
// 超时时间设置为5秒，最多重试3次，每次重试间隔100毫秒
$response = Http::timeout(5)
->retry(3, 100)
->post('https://ipipp.com/api/notify', [
'msg' => 'test notification'
]);
<?php
自定义HTTP请求辅助函数
如果项目中存在大量重复的请求逻辑，可以自定义辅助函数进一步简化操作，避免代码冗余。
首先在app/Helpers目录下创建HttpHelper.php文件，编写自定义辅助函数：
<?php
use IlluminateSupportFacadesHttp;
if (!function_exists('send_get_request')) {
/**
* 自定义GET请求辅助函数
* @param string $url 请求地址
* @param array $params 查询参数
* @param array $headers 自定义请求头
* @return array 响应结果数组，包含status和data字段
*/
function send_get_request(string $url, array $params = [], array $headers = []): array
{
$request = Http::withHeaders($headers);
$response = empty($params) ? $request->get($url) : $request->get($url, $params);
return [
'status' => $response->status(),
'data' => $response->json()
];
}
}
if (!function_exists('send_post_request')) {
/**
* 自定义POST请求辅助函数
* @param string $url 请求地址
* @param array $data 请求体数据
* @param array $headers 自定义请求头
* @param bool $isJson 是否为json格式请求
* @return array 响应结果数组
*/
function send_post_request(string $url, array $data = [], array $headers = [], bool $isJson = true): array
{
$request = Http::withHeaders($headers);
if ($isJson) {
$request->asJson();
}
$response = $request->post($url, $data);
return [
'status' => $response->status(),
'data' => $response->json()
];
}
}
<?php
之后在composer.json的autoload配置中添加该文件路径，执行composer dump-autoload命令加载辅助函数，就可以在项目中直接调用：
<?php
// 调用自定义GET辅助函数
$result = send_get_request('https://ipipp.com/api/config', [], ['Authorization' => 'Bearer test_token']);
// 调用自定义POST辅助函数
$result2 = send_post_request('https://ipipp.com/api/log', ['action' => 'login'], [], false);
<?php
响应处理常用方法
请求发送后会返回响应对象，Laravel提供了多个方法方便开发者处理响应内容：
status()：获取HTTP响应状态码json()：将json格式的响应内容解析为数组，非json内容返回nullbody()：获取原始的响应内容字符串ok()：判断响应状态码是否为200，返回布尔值failed()：判断请求是否失败，返回布尔值header(string $name)：获取指定响应头的值
以下是响应处理的示例代码：
<?php
use IlluminateSupportFacadesHttp;
$response = Http::get('https://ipipp.com/api/article/1');
if ($response->ok()) {
$article = $response->json();
$title = $article['title'] ?? '';
echo "文章标题：{$title}";
} else {
echo "请求失败，状态码：{$response->status()}";
}
<?php
常见注意事项
使用Laravel HTTP客户端时需要注意以下几点：
1. 使用前需要确认项目已经安装了guzzlehttp/guzzle依赖，Laravel默认已经包含该依赖，若手动移除需要重新安装。
2. 请求第三方地址时如果返回SSL证书错误，可以在开发环境临时使用withoutVerifying()方法跳过证书验证，但生产环境不建议使用。3. 大量并发请求场景建议使用异步请求方法async()，避免阻塞当前进程，提升执行效率。通过以上方法，开发者可以在PHP项目中高效处理HTTP请求，尤其是Laravel项目通过内置辅助函数和自定义封装，能大幅减少请求相关的重复代码，提升开发效率。
PHPLaravelHTTP_client请求简化修改时间：2026-06-26 12:42:40