PHP：将shell_exec调用的cURL转为Guzzle格式及405错误解决

别慌，咱们先理清楚问题根源——405错误意味着服务器不认可你当前发送的请求方法，但你原有的curl POST请求是正常的，那肯定是Guzzle的代码和原curl命令的配置没对齐，咱们一步步排查修复：

首先你得把shell_exec里的原curl命令拆解透，比如假设你的curl是这样的（举个常见例子）：

curl -X POST "https://your-target-url.com/api" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-token" \
  -d '{"username": "test", "password": "123456"}'

那对应的Guzzle代码必须完全匹配每一个参数，不能有遗漏：

use GuzzleHttp\Client;

// 初始化客户端
$client = new Client();

try {
    $response = $client->post('https://your-target-url.com/api', [
        // 对应curl里的-H头信息
        'headers' => [
            'Content-Type' => 'application/json',
            'Authorization' => 'Bearer your-token',
            // 别忘了如果curl里有User-Agent之类的自定义头，也要加上
            'User-Agent' => 'curl/7.68.0'
        ],
        // 对应curl里的-d JSON数据
        'json' => [
            'username' => 'test',
            'password' => '123456'
        ]
    ]);

    // 处理正常响应
    $responseBody = $response->getBody()->getContents();
    var_dump($responseBody);
} catch (\GuzzleHttp\Exception\RequestException $e) {
    // 捕获错误便于排查
    echo "请求错误: " . $e->getMessage() . "\n";
    if ($e->hasResponse()) {
        echo "服务器响应: " . $e->getResponse()->getBody()->getContents() . "\n";
    }
}

我整理了几个最容易踩的点，你可以逐一排查：

• 请求方法写错：别手抖把$client->post()写成了get()或者put()，这是最基础的错误，但很容易犯。
• 请求体格式不匹配：如果原curl用的是-d "key=value"（表单格式，Content-Type是application/x-www-form-urlencoded），那Guzzle不能用json参数，得换成form_params：

  $response = $client->post('https://your-target-url.com/api', [
      'headers' => [
          'Content-Type' => 'application/x-www-form-urlencoded',
      ],
      'form_params' => [
          'key' => 'value',
          'another_key' => 'another_value'
      ]
  ]);
  

• 遗漏了URL里的查询参数：如果原curl的URL是https://your-target-url.com/api?foo=bar，那Guzzle里必须完整带上这个URL，或者用query参数单独传递：

  $response = $client->post('https://your-target-url.com/api', [
      'query' => [
          'foo' => 'bar'
      ],
      // 其他配置...
  ]);
  

• 头信息缺失：有些服务器会校验特定头（比如User-Agent、Referer），如果原curl里有这些头，Guzzle里必须原样加上，不然服务器可能会把请求路由到不接受POST的端点。

如果还是找不到问题，那就把Guzzle发送的请求和curl的请求做精准对比：

1. 先执行curl -v your-curl-command，复制下完整的请求日志（包括请求方法、头、体）。
2. 给Guzzle加上调试中间件，打印出实际发送的请求：

   use GuzzleHttp\Client;
   use GuzzleHttp\HandlerStack;
   use GuzzleHttp\Middleware;
   
   $handlerStack = HandlerStack::create();
   // 添加调试中间件，打印请求详情
   $handlerStack->push(Middleware::tap(function ($request) {
       echo "=== Guzzle 请求详情 ===\n";
       echo "请求方法: " . $request->getMethod() . "\n";
       echo "请求URL: " . $request->getUri() . "\n";
       echo "请求头: " . json_encode($request->getHeaders(), JSON_PRETTY_PRINT) . "\n";
       echo "请求体: " . $request->getBody()->getContents() . "\n";
   }));
   
   $client = new Client(['handler' => $handlerStack]);
   // 然后执行你的POST请求...
   

把两者的请求细节对比，就能一眼看出哪里不一样了，比如少了某个头、请求体格式不对，或者URL有差异。

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