🎤 Laravel HTTP 客户端拦截与响应转换机制讲座

大家好！欢迎来到今天的 Laravel HTTP 客户端 技术分享会。我是你们的讲师，一个热爱代码、喜欢用表情符号调味的程序员 😊。今天我们将一起探讨如何在 Laravel 中优雅地拦截客户端请求，并对响应结果进行转换处理。准备好了吗？那就让我们开始吧！

---

🚀 开场：为什么需要拦截和转换？

在日常开发中，我们经常需要通过 HTTP 客户端调用外部 API 来获取数据。然而，这些 API 的返回结果可能并不总是符合我们的需求，比如：

• 返回的数据格式不符合预期（JSON 格式混乱）。
• 需要对错误状态码进行统一处理。
• 想要在请求发送前添加自定义逻辑（如认证头信息）。

这时，Laravel 提供了强大的工具来帮助我们实现这些需求——HTTP 客户端拦截器 和 响应转换机制。

---

🌟 第一讲：HTTP 客户端基础回顾

在 Laravel 7+ 中，官方提供了 Http Facade，这是一个非常方便的工具，用于发起 HTTP 请求。以下是一个简单的示例：

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

但是，如果我们需要在每次请求或响应时都执行一些额外的操作，该怎么办呢？这就需要用到 Laravel 的 宏机制 和 事件监听器。

---

🔍 第二讲：拦截请求的艺术

1. 使用宏扩展功能 🛠️

Laravel 的 HTTP 客户端支持通过 宏 来扩展功能。我们可以利用宏在请求发送前插入自定义逻辑。例如，添加全局的认证头信息：

use IlluminateSupportFacadesHttp;

Http::macro('withAuth', function ($token) {
    return Http::withHeaders([
        'Authorization' => 'Bearer ' . $token,
    ]);
});

// 使用示例
$response = Http::withAuth('your-auth-token')->get('https://api.example.com/protected');

💡 小贴士：宏是一种非常灵活的方式，可以让你为 HTTP 客户端注入任何自定义逻辑。

2. 使用中间件拦截请求 📬

如果你更喜欢使用中间件来处理请求，可以通过创建自定义中间件来实现。例如：

namespace AppHttpMiddleware;

use Closure;
use IlluminateSupportFacadesHttp;

class AddGlobalHeader
{
    public function handle($request, Closure $next)
    {
        Http::macro('globalHeader', function () {
            return Http::withHeaders([
                'X-Custom-Header' => 'CustomValue',
            ]);
        });

        return $next($request);
    }
}

然后，在 Kernel.php 中注册该中间件：

protected $middleware = [
    AppHttpMiddlewareAddGlobalHeader::class,
];

这样，所有的 HTTP 请求都会自动带上 X-Custom-Header。

---

🔄 第三讲：响应结果的转换魔法

当我们从外部 API 获取数据时，可能会遇到以下问题：

• 返回的 JSON 数据结构复杂，需要提取特定字段。
• 响应状态码异常时需要抛出自定义异常。

Laravel 提供了多种方式来解决这些问题。

1. 使用 tap 方法处理响应 🧪

tap 是一个非常优雅的方法，允许我们在不改变原始响应的情况下对其进行操作。例如：

$response = Http::get('https://api.example.com/data')
    ->tap(function ($response) {
        if ($response->failed()) {
            Log::error('API request failed: ' . $response->body());
        }
    });

$data = $response->json();

2. 自定义响应转换逻辑 ✨

如果需要对响应数据进行深度处理，可以编写一个辅助函数。例如：

function transformApiResponse($response)
{
    $data = $response->json();

    // 提取我们需要的字段
    return [
        'id' => $data['id'] ?? null,
        'name' => $data['name'] ?? 'Unknown',
        'status' => $data['status'] ?? 'Inactive',
    ];
}

$response = Http::get('https://api.example.com/data');
$transformedData = transformApiResponse($response);

3. 统一异常处理 🛑

为了更好地管理错误状态码，我们可以使用 throw() 方法。例如：

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

    $data = $response->json();
} catch (IlluminateHttpClientRequestException $e) {
    report($e); // 记录错误日志
    return response()->json(['error' => 'API request failed'], 500);
}

💡 小贴士：throw() 方法会在响应失败时自动抛出异常，非常适合统一错误处理。

---

📊 第四讲：总结对比表

为了让大家更直观地理解上述方法的区别，这里提供一个对比表：

方法	描述	适用场景
宏扩展	在请求发送前插入自定义逻辑	全局头信息、认证等
中间件	通过中间件拦截并修改请求	更复杂的全局逻辑
tap 方法	对响应进行非破坏性操作	日志记录、简单验证
自定义转换函数	深度处理响应数据	数据结构复杂的情况
throw 方法	统一处理错误状态码	错误状态码的集中管理

---

🎉 结语

今天的讲座到这里就结束了！希望你已经掌握了 Laravel HTTP 客户端的拦截与响应转换机制。记住，编程就像烹饪，不同的食材（方法）可以组合成美味的菜肴（解决方案）。多尝试、多实践，你一定能成为 Laravel 的大师！

最后，别忘了给这篇文章点个赞 ❤️，或者留下你的疑问和想法。我们下次见！👋