Laravel使API交互对新的和有经验的Web开发人员来说都是轻而易举的。Larvel的HTTP客户端是建立在PHP的Guzzle HTTP客户端之上，让开发者在进行HTTP请求时有更顺畅的体验。它的主要功能包括认证, 路由, 和有效的对象关系映射(ORM).
本文将探讨如何使用Laravel的HTTP客户端来进行请求, 调试响应, 创建中间件和宏, 以及更多。
Laravel HTTP客户端为你的API工作
Guzzle是一个简单的PHP的HTTP客户端。它为不同的表单请求提供了功能，包括 GET, POST, PUT, 和 DELETE ，以及流媒体功能和多部分请求。使用Guzzle HTTP客户端，可以向服务器发送同步和异步的请求。此外，它还配备了体面的中间件来定制客户端的行为。
Laravel的HTTP客户端是一个建立在Guzzle基础上的封装器，但具有额外的功能。它包括支持重试失败的请求和一些JSON数据的辅助功能。Laravel HTTP客户端的大部分功能都与Guzzle类似。
前提条件
在下面的章节中, 你会了解到更多关于Laravel的HTTP客户端。要继续学习, 你需要：
如何发出请求
要了解如何使用HTTP客户端来发出请求, 你可以利用大量的托管API, 如ReqRes.
首先，导入创建应用程序时包含的HTTP包。在App/Http/Controllers/UserController.php文件中，添加以下代码，从文件开头的use语句开始，其余代码在index函数中。
use Illuminate\Support\Facades\Http;
return Http::get("https://reqres.in/api/users?page=2");
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都是其成功的关键。然而，使用它们可能是困难的。
许多框架和库都承诺简化这一过程, 但Laravel因其专注于简单性和易用性而脱颖而出. 他们内置的客户端支持简单的API调用, 并发的API调用, API Macros, 基于JSON的API的辅助方法, 以及更多。
评论留言