本文档旨在帮助开发者理解如何正确使用 Laravel 的 Guzzle HTTP 客户端发送 JSON 数据。
Laravel 框架提供了一个基于 Guzzle HTTP 客户端的便捷封装，用于发送 HTTP 请求。在使用该客户端向 API 发送 JSON 数据时，可能会遇到服务端无法识别 JSON 对象属性的问题，例如服务端报告找不到请求中的 Id 属性。这通常是由于在请求中错误地使用了 'json' 属性导致的。
根据 Laravel 官方文档，默认情况下，通过 HTTP 客户端发送数据时，内容类型会被设置为 application/json。因此，无需显式地将数据包装在 'json' 属性中。
正确的做法是直接将数据数组传递给 post 方法。
以下是一个示例：
use Illuminate\Support\Facades\Http;
$url = "https://blablabla.com/api";
$key = "1234";
$data = [
'Id' => "4"
];
$response = Http::withHeaders([
"Authorization" => $key
])->post($url, $data);
// 处理响应
if ($response->successful()) {
// 请求成功
$responseData = $response->json();
// ...
} else {
// 请求失败
// ...
}代码解释：
- use Illuminate\Support\Facades\Http;: 导入 Laravel 的 HTTP facade，方便使用 HTTP 客户端。
- $url: 定义 API 的 URL 地址。
- $key: 定义授权所需的 API Key。
- $data: 定义要发送的 JSON 数据，这是一个关联数组。
- Http::withHeaders(...): 使用 withHeaders 方法设置请求头，例如 Authorization。
- ->post($url, $data): 使用 post 方法发送 POST 请求，直接将 $data 数组作为第二个参数传递。Laravel 的 HTTP 客户端会自动将数据转换为 JSON 格式，并设置 Content-Type 为 application/json。
- $response->successful(): 检查响应状态码是否在 200-299 范围内，表示请求成功。
- $response->json(): 将响应体解析为 JSON 格式的数组或对象。
注意事项：
确保服务端能够正确解析 application/json 格式的数据。
-
如果服务端需要特定的 Content-Type，可以使用 withHeaders 方法进行设置。例如：
$response = Http::withHeaders([ "Authorization" => $key, "Content-Type" => "application/xml" // 示例：设置为 application/xml ])->post($url, $data); 如果需要发送更复杂的数据结构，例如嵌套的数组或对象，Laravel 的 HTTP 客户端也会自动将其转换为 JSON 格式。
请始终检查响应状态码，以确保请求成功。
总结：
使用 Laravel 的 Guzzle HTTP 客户端发送 JSON 数据时，避免显式使用 'json' 属性，直接将数据数组传递给 post 方法即可。这可以确保数据以 application/json 内容类型发送，并避免服务端解析错误。始终检查响应状态码和内容类型，以确保请求成功并获得期望的结果。
