🎤 Laravel HTTP 客户端的请求拦截与响应处理高级定制：一场轻松愉快的技术讲座

大家好！👋 欢迎来到今天的 Laravel 技术讲座。今天我们将一起探讨如何在 Laravel 中使用 HTTP 客户端进行请求拦截和响应处理的高级定制。如果你曾经被复杂的 API 调用搞得头昏脑涨，那么今天的内容一定会让你豁然开朗！😎

---

🌟 讲座大纲

1. Laravel HTTP 客户端简介
2. 请求拦截的艺术
3. 响应处理的魔法
4. 高级定制技巧
5. 实战演练

---

1. Laravel HTTP 客户端简介 📖

Laravel 提供了一个强大的 HTTP 客户端（IlluminateSupportFacadesHttp），它基于 Guzzle 构建，但提供了更简洁的语法和更好的集成体验。

简单来说，Laravel 的 HTTP 客户端可以让你像这样发送请求：

$response = Http::get('https://api.example.com/data');
$data = $response->json();

是不是看起来很清爽？👍 但是，如果我们需要对每次请求或响应都做一些额外的操作，比如添加全局的请求头、日志记录或者错误处理怎么办？这就需要用到请求拦截和响应处理了！

---

2. 请求拦截的艺术 ✨

什么是请求拦截？

请求拦截就是在请求发送之前对其进行修改或增强。例如，你可以在每个请求中自动添加认证令牌、用户代理或者其他自定义头信息。

如何实现？

Laravel 提供了一个非常方便的方法——Http::macro()，可以用来定义全局的请求拦截器。

示例代码：添加全局请求头

use IlluminateSupportFacadesHttp;

Http::macro('withCustomHeaders', function () {
    return Http::withHeaders([
        'Authorization' => 'Bearer YOUR_ACCESS_TOKEN',
        'User-Agent' => 'MyApp/1.0',
    ]);
});

// 使用时
$response = Http::withCustomHeaders()->get('https://api.example.com/data');

在这个例子中，我们通过 Http::macro() 定义了一个全局的宏 withCustomHeaders，它会在每个请求中自动添加指定的头信息。

国外文档引用：

"Macros allow you to add custom methods to the HTTP client, providing a way to extend its functionality." — Laravel Documentation

---

3. 响应处理的魔法 🔮

什么是响应处理？

响应处理就是在收到服务器返回的数据后，对其进行解析、转换或记录。例如，你可以将 JSON 数据自动转换为对象，或者在遇到错误时抛出自定义异常。

如何实现？

Laravel 提供了多种方法来处理响应，比如 tap() 和 throw()。

示例代码：自动处理错误响应

$response = Http::get('https://api.example.com/data')
    ->throw(); // 如果状态码不是 2xx，会抛出异常

try {
    $data = $response->json();
} catch (IlluminateHttpClientRequestException $e) {
    Log::error('API Error: ' . $e->getMessage());
}

在这个例子中，throw() 方法会自动检测响应的状态码，并在非 2xx 状态时抛出异常。

自定义响应处理

如果你想对响应数据进行更复杂的处理，可以使用 map() 方法：

$response = Http::get('https://api.example.com/data')
    ->map(function ($response) {
        return collect($response)->only(['id', 'name']); // 只保留特定字段
    });

---

4. 高级定制技巧 🛠️

技巧 1：全局中间件

如果你想为所有 HTTP 请求添加统一的逻辑，可以使用 before 和 after 方法。

示例代码：全局日志记录

Http::fake([
    '*' => Http::sequence()
        ->before(function (Request $request) {
            Log::info('Sending request to: ' . $request->url());
        })
        ->push(function () {
            return new Response(200, ['Content-Type' => 'application/json'], '{"status":"success"}');
        })
        ->after(function (Response $response) {
            Log::info('Received response: ' . $response->body());
        }),
]);

技巧 2：条件化请求

有时候你可能需要根据某些条件动态调整请求参数。可以使用 when() 方法。

示例代码：条件化请求头

$response = Http::when(auth()->check(), function () {
    return Http::withToken(auth()->user()->api_token);
})->get('https://api.example.com/data');

---

5. 实战演练 🏋️‍♂️

假设我们需要开发一个天气查询功能，调用 OpenWeatherMap API，并对以下场景进行处理：

• 添加 API 密钥作为查询参数。
• 自动解析 JSON 响应。
• 在请求失败时记录错误日志。

完整代码示例

use IlluminateSupportFacadesHttp;
use IlluminateSupportFacadesLog;

Http::macro('weather', function () {
    return Http::baseUrl('https://api.openweathermap.org/data/2.5')
        ->query(['appid' => 'YOUR_API_KEY']);
});

try {
    $response = Http::weather()->get('/weather', [
        'q' => 'Beijing',
    ])->throw();

    $weather = $response->json();
    echo "Current temperature in Beijing: " . $weather['main']['temp'];
} catch (IlluminateHttpClientRequestException $e) {
    Log::error('Weather API Error: ' . $e->getMessage());
}

---

总结 🎉

今天我们一起学习了如何在 Laravel 中使用 HTTP 客户端进行请求拦截和响应处理的高级定制。通过这些技巧，你可以让 API 调用变得更加优雅和高效。

记住，技术的核心在于解决问题，而 Laravel 的 HTTP 客户端正是为此而生。💪

如果有任何问题，欢迎随时提问！😊