Laravel9 Http::post如何强制传递字符串而非数组作为POST请求参数

Laravel 9 内置的HTTP客户端基于Guzzle封装，默认会对post方法第二个参数传入的请求数据做自动格式适配：即使你传入了http_build_query生成的urlencoded字符串，客户端也会默认将其解析为数组，再根据请求头的Content-Type重新编码后发送，整个自动转换过程可能改变参数顺序、编码规则，和你原本生成的字符串内容不一致，最终导致对接的API返回校验错误。

方法1：强制发送原始请求体（适配需要自定义签名的场景） #

调用withBody方法直接传入你生成好的字符串内容，该方法会完全跳过客户端的自动参数转换逻辑，将内容原样发送给服务端，是最符合你需求的方案。
修改后的代码如下：

$array = [
    'key1' => 'value1',
    'key2' => 'value2',
    // 其他业务参数
];
$headers = [
    'Content-Type' => 'application/x-www-form-urlencoded',
    'HMAC' => $hmac
];

$data = http_build_query($array, '', '&');
// withBody第一个参数为原始请求内容，第二个参数为内容对应的Content-Type
$response = Http::withHeaders($headers)
    ->withBody($data, 'application/x-www-form-urlencoded')
    ->post($api_url);
// 注意原代码此处多了一个多余的右括号，已修正
return json_decode($response->getBody());

注意：如果你的HMAC签名是基于手动生成的$data字符串计算的，必须使用该方法，避免客户端自动编码后的内容和签名计算的原文不一致，导致签名校验失败。

方法2：使用内置表单请求方法（无自定义编码需求时可用） #

如果你不需要自定义参数编码逻辑、也不需要绑定签名和自定义编码字符串，可以直接调用客户端内置的asForm()方法，传入数组参数即可，客户端会自动按标准application/x-www-form-urlencoded格式编码发送请求，不需要手动调用http_build_query：

$response = Http::withHeaders(['HMAC' => $hmac])
    ->asForm()
    ->post($api_url, $array);
return json_decode($response->getBody());

• 不要把自定义编码后的字符串传入post方法的第二个参数，该位置的参数始终会触发客户端的自动格式转换逻辑，只有withBody传入的内容会被原样发送。
• 原业务代码最后一行json_decode($response->getBody()))存在语法错误，多了一个闭合括号，运行会报错，需要删除多余的括号。

内容的提问来源于stack exchange，提问作者ForceMan