首页 > php框架 > Laravel > 正文

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

穿越時空
发布: 2025-12-02 11:19:03
原创
547人浏览过
Laravel内置HTTP客户端基于Guzzle,安装guzzlehttp/guzzle后可通过Http门面发起请求。1. 使用Http::get()、Http::post()等方法发送GET、POST请求,支持查询参数和JSON数据传输;2. 通过withHeaders()设置请求头,withToken()添加Bearer Token认证;3. 支持超时timeout()、连接超时connectTimeout()及重试retry()机制;4. 可用throw()自动处理4xx/5xx错误响应;5. 发送表单数据使用asForm(),文件上传通过attach()实现;6. 可复用配置创建客户端实例,提升代码可读性与维护性。

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')

例如:

腾讯Effidit
腾讯Effidit

腾讯AI Lab开发的AI写作助手,提升写作者的写作效率和创作体验

腾讯Effidit 65
查看详情 腾讯Effidit
$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,代码清晰又安全。

以上就是Laravel的HTTP客户端怎么用_Laravel HTTP Client发起API请求教程的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号