Laravel使API交互对新的和有经验的Web开发人员来说都是轻而易举的。Larvel的HTTP客户端是建立在PHP的Guzzle HTTP客户端之上,让开发者在进行HTTP请求时有更顺畅的体验。它的主要功能包括认证, 路由, 和有效的对象关系映射(ORM).
本文将探讨如何使用Laravel的HTTP客户端来进行请求, 调试响应, 创建中间件和宏, 以及更多。
Laravel HTTP客户端为你的API工作
Guzzle是一个简单的PHP的HTTP客户端。它为不同
use Illuminate\Support\Facades\Http;
return Http::get("https://reqres.in/api/users?page=2");
的表单请求提供了功能,包括 GET
, POST
, PUT
, 和 DELETE
,以及流媒体功能和多部分请求。使用Guzzle HTTP客户端,可以向服务器发送同步和异步的请求。此外,它还配备了体面的中间件来定制客户端的行为。
Laravel的HTTP客户端是一个建立在Guzzle基础上的封装器,但具有额外的功能。它包括支持重试失败的请求和一些JSON数据的辅助功能。Laravel HTTP客户端的大部分功能都与Guzzle类似。
前提条件
在下面的章节中, 你会了解到更多关于Laravel的HTTP客户端。要继续学习, 你需要:
- 有关Laravel, PHP, 和API的基本知识
- 安装了PHP和Composer
- Postman
如何发出请求
要了解如何使用HTTP客户端来发出请求, 你可以利用大量的托管API, 如ReqRes.
首先,导入创建应用程序时包含的HTTP包。在App/Http/Controllers/UserController.php文件中,添加以下代码,从文件开头的use语句开始,其余代码在index函数中。
Note: 对于复杂的用例,你也可以通过使用 withHeaders
方法发送带头文件的请求。
在同一个文件中,使用下面的代码创建一个新的方法帖子:
function post()
{
$response = Http::withHeaders([
'Content-Type' => 'application/json',
])->post('https://reqres.in/api/users', [
'name' => 'morpheus',
'job' => 'leader',
]);
return $response;
}
然后在routes/web.php文件中为其添加一个路由:
Route::get('post',[UserController::class,'post']);
现在,可以用Postman来测试这个路由。打开Postman,添加http://127.0.0.1:8000/post 作为URL,请求类型为 GET
。一旦你点击send,你会看到下面的响应:
使用Postman发出请求
并行请求
并发请求可以显著提高性能,因为你可以在同一时间段内获取更多的数据。Laravel的HTTP客户端使得使用pool方法进行并发请求成为可能。
在App/Http/Controllers/UserController.php里面, 添加以下代码:
use Illuminate\Http\Client\Pool;
function concurrent()
{
$responses = Http::pool(fn (Pool $pool) => [
$pool->get('https://reqres.in/api/users?page=2'),
$pool->get('https://reqres.in/api/users/2'),
$pool->get('https://reqres.in/api/users?page=2'),
]);
return $responses[0]->ok() &&
$responses[1]->ok() &&
$responses[2]->ok();
}
然后,在routes/web.php文件中添加支持性路由。
Route::get('concurrent',[UserController::class,'concurrent']);
浏览器在访问该路由时,会给出如下响应:
并发请求
请求宏
请求宏在与常见的API路径进行交互时非常有用。
要创建宏,你需要使用下面的代码在App/Http/Controllers/UserController.php文件的启动方法内定义宏:
use Illuminate\Support\Facades\Http;
Http::macro('reqres', function () {
return Http::baseUrl('https://reqres.in/api');
});
Note:请确保在文件的开头添加使用语句。
然后,在 UserController
里面使用这个宏,添加以下代码:
function macro()
{
$response = Http::reqres()->get('/users?page=2');
return $response;
}
正如你所看到的,因为宏已经被创建了,你不必再添加完整的URL。
最后,使用下面的代码在routes/web.php文件中添加一个路由:
Route::get('macro',[UserController::class,'macro']);
宏请求
如何对响应进行解码
要解码一个响应并确保一个API请求是成功的,你可以使用客户端中的status方法。这个方法获得从服务器发送的状态代码并显示出来。
为了测试这一点,在App/Http/Controllers/UserController.php文件中用下面的代码替换之前的宏代码:
function macro()
{
$response = Http::reqres()->get('/users?page=2');
return $response->status();
}
这里,状态代码200意味着请求成功。
成功解码响应
如何测试JSON APIs
Laravel有几个辅助函数来测试JSON APIs和它们的响应。这些辅助函数包括json, getJson, postJson, putJson, patchJson, deleteJson, 等等。
为了更好地理解测试,为 GET
用户的路由创建一个测试场景。当你启动Laravel应用程序时, Example Test已经被创建。在test/Feature/ExampleTest.php文件中, 用以下内容替换现有代码:
<?php
namespace Tests\Feature;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;
class ExampleTest extends TestCase
{
/**
* A basic test example.
*
* @return void
*/
public function test_example()
{
$response = $this->getJson('/users');
$response->assertStatus(200);
}
}
添加的代码在用户的路线上获取JSON数据,并检查状态代码是否为200。
一旦你添加了测试代码,在你的终端运行以下命令来运行测试:
./vendor/bin/phpunit
一旦测试完成,你会看到它运行了两个测试,都是成功的。
测试JSON APIs
同样地,你可以检查不同类型的请求,并利用其他辅助方法进行更复杂的测试。
如何处理事件
Laravel在处理HTTP请求时提供了三个事件。
- RequestSending, 这是在请求被发送之前。
- ResponseReceived, 这是当收到一个响应。
- ConnectionFailed, 这是在没有收到响应的时候。
所有这三个事件都包括$ request
属性,用来检查 Illuminate\Http\Client\Request
实例,而 ResponseReceived
有一个额外的 $response property
。这些对于在事件后执行行动特别有用。例如,你可能想在得到一个成功的响应后发送电子邮件。
要创建一个事件和监听器,请浏览app/Providers/EventServiceProvider.php文件,用以下代码替换listen数组。
protected $listen = [
Registered::class => [
SendEmailVerificationNotification::class,
],
'Illuminate\Http\Client\Events\ResponseReceived' => [
'App\Listeners\LogResponseReceived',
],
];
然后在你的终端运行以下命令:
php artisan event:generate
上述命令将创建app/Listeners/LogResponseReceived.php监听器。用下面的代码替换该文件的代码:
<?php
namespace App\Listeners;
use Illuminate\Http\Client\Events\ResponseReceived;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
use Illuminate\Support\Facades\Log;
class LogResponseReceived
{
/**
* Create the event listener.
*
* @return void
*/
public function __construct(Request $request, Response $response)
{
Log::channel('stderr')->info($response->status());
}
/**
* Handle the event.
*
* @param \Illuminate\Http\Client\Events\ResponseReceived $event
* @return void
*/
public function handle(ResponseReceived $event)
{
}
}
状态代码的信息日志被输出到终端。
显示状态代码的终端日志
小结
无论一个网站或网络应用是由一个组织或独立开发者制作的,API都是其成功的关键。然而,使用它们可能是困难的。文章来源:https://www.toymoban.com/news/detail-811317.html
许多框架和库都承诺简化这一过程, 但Laravel因其专注于简单性和易用性而脱颖而出. 他们内置的客户端支持简单的API调用, 并发的API调用, API Macros, 基于JSON的API的辅助方法, 以及更多。文章来源地址https://www.toymoban.com/news/detail-811317.html
到了这里,关于如何使用Laravel的HTTP客户端与外部API交互的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!