🎤 Laravel HTTP 客户端：请求拦截与响应转换的艺术讲座

大家好！欢迎来到今天的 Laravel 技术分享会 🎉。今天我们要聊一聊 Laravel 的 HTTP 客户端（Laravel HTTP Client），它就像一个超级快递员，负责帮你把数据从 A 地送到 B 地，然后再把结果带回来。但有时候，我们可能想在数据出发前“偷偷改点东西”，或者在结果回来后“再加工一下”。这就要用到 请求拦截 和 响应转换 了！

如果你觉得这些概念听起来有点复杂，别担心！我会用轻松诙谐的语言和实际代码来解释它们。准备好了吗？那就让我们开始吧！✨

---

🔍 什么是请求拦截？

请求拦截就是我们在发送 HTTP 请求之前，对请求的内容进行一些修改或增强的过程。比如，你可能想：

• 自动添加某些头部信息（如 API 密钥）。
• 修改请求的 URL 或参数。
• 记录请求的日志。

🛠️ 如何实现请求拦截？

Laravel 提供了一个强大的工具叫做 Before Sending 回调，允许你在请求发送前插入自定义逻辑。下面是一个简单的例子：

Http::withOptions([
    'before' => function (PsrHttpMessageRequestInterface $request) {
        // 在这里可以修改请求对象
        echo "即将发送请求到: " . $request->getUri() . "n";

        // 添加自定义头部
        $request = $request->withHeader('X-Custom-Header', 'MyValue');

        return $request;
    },
])->get('https://jsonplaceholder.typicode.com/posts/1');

在这个例子中，我们使用了 before 回调函数，它接收一个 RequestInterface 对象作为参数。你可以通过这个对象修改请求的任何部分，比如 URL、头部、方法等。

💡 小贴士：PsrHttpMessageRequestInterface 是 PSR-7 标准的一部分，Laravel 的 HTTP 客户端完全兼容这个标准。

---

📦 响应结果的转换机制

当请求返回时，我们通常会得到一个原始的 HTTP 响应对象。但很多时候，我们希望直接获取 JSON 数据，或者将响应格式化为某种特定的结构。这就需要用到响应转换了！

🛠️ 如何实现响应转换？

Laravel 提供了几种内置的方法来处理响应，比如 json()、body() 和 status()。但如果你想更灵活地控制响应处理过程，可以使用 macro 或者自定义逻辑。

示例 1：使用 json() 方法

假设我们从 API 获取了一些数据：

$response = Http::get('https://jsonplaceholder.typicode.com/posts/1');
$data = $response->json(); // 自动解析 JSON 响应

json() 方法会自动尝试将响应体解析为 PHP 数组或对象。如果响应不是有效的 JSON 格式，它会抛出异常。

示例 2：自定义响应处理

如果你需要更复杂的逻辑，比如只提取某些字段，或者对数据进行过滤，可以这样做：

$response = Http::get('https://jsonplaceholder.typicode.com/posts/1');

// 自定义处理逻辑
$processedData = [
    'id' => $response->json('id'),
    'title' => strtoupper($response->json('title')),
];

print_r($processedData);

在这个例子中，我们只提取了 id 和 title 字段，并且将标题转换为大写。

---

🌟 实战技巧：结合拦截与转换

现在我们已经学会了如何拦截请求和转换响应，接下来让我们看一个更复杂的场景——结合两者来实现一个完整的流程。

假设我们需要向一个 API 发送请求，并且：

1. 自动添加认证令牌。
2. 如果响应是错误状态码，则记录日志。
3. 返回解析后的 JSON 数据。

以下是实现代码：

Http::withOptions([
    'headers' => ['Authorization' => 'Bearer YOUR_TOKEN'], // 自动添加头部
    'before' => function (PsrHttpMessageRequestInterface $request) {
        // 拦截请求并打印日志
        echo "请求地址: " . $request->getUri() . "n";
        return $request;
    },
])->get('https://jsonplaceholder.typicode.com/posts/1')
    ->throw() // 如果状态码不是 2xx，抛出异常
    ->json(); // 解析 JSON 响应

关键点解析

• withOptions：用于设置全局选项，比如默认头部。
• before 回调：在请求发送前执行逻辑。
• throw()：如果响应状态码不是 2xx，会抛出异常，方便调试。
• json()：自动解析 JSON 响应。

---

📊 表格总结：请求与响应的关键方法

为了让大家更清楚地了解 Laravel HTTP 客户端的核心功能，我整理了一个表格：

方法名	描述	示例值
get()	发送 GET 请求	Http::get('url')
post()	发送 POST 请求	Http::post('url', [])
put()	发送 PUT 请求	Http::put('url', [])
delete()	发送 DELETE 请求	Http::delete('url')
withToken()	添加 Bearer Token	Http::withToken('token')
withHeaders()	添加自定义头部	Http::withHeaders([])
json()	解析 JSON 响应	$response->json()
status()	获取状态码	$response->status()
body()	获取原始响应体	$response->body()

---

🧠 思考题

1. 如果你需要在多个地方重复使用相同的请求拦截逻辑，你会怎么设计？
2. 假设 API 返回的数据格式不固定，你会如何动态处理响应？

---

🎉 结语

今天的分享就到这里啦！通过学习 Laravel HTTP 客户端的请求拦截和响应转换机制，我们可以更加灵活地处理 HTTP 请求和响应。希望大家能将这些技巧应用到自己的项目中，让代码变得更加优雅和高效 😄。

如果有任何问题，欢迎在评论区留言！下次见啦，拜拜～ 👋