Guzzle 安装后不能直接使用，因默认配置未适配运行环境：需确保 PHP 启用 curl 扩展、正确配置 CA 证书路径、显式设置 timeout（浮点秒）、verify（生产为 true）和 http_errors（false），并区分 form_params 与 json 参数提交方式。
Composer 安装 Guzzle 是可靠的，但直接 composer require guzzlehttp/guzzle 后立刻发请求，大概率会遇到连接超时、SSL 验证失败或返回空响应——问题不在安装，而在默认配置和运行环境没对齐。
为什么 composer require guzzlehttp/guzzle 装完不能直接用
装包只是把类库放进 vendor/，Guzzle 本身不自动配置 PHP 的网络能力。常见卡点：
- PHP 缺少
curl扩展（尤其 Windows 或 Docker 精简镜像）——php -m | grep curl为空就挂了 - 系统 CA 证书路径不对，导致 HTTPS 请求报
cURL error 60: SSL certificate problem - 没设超时，遇到慢接口直接卡死（默认无超时，不是 0，是“无限等”）
- 没检查返回状态码，
200和500都返回Response对象，但内容天差地别
发 GET 请求前必须配的三个参数
别信“一行搞定”，至少要显式控制这三项，否则线上容易静默失败：
-
timeout：设成5.0或10.0（浮点数），单位秒；设整数5会被 Guzzle 当作毫秒处理 -
verify：生产环境务必为true（验证证书），开发若遇自签名证书，临时设false，但绝不能提交到 Git -
http_errors：设为false，否则4xx/5xx响应直接抛RequestException，得用 try/catch 包一层才取得到 body
示例：
$client = new \GuzzleHttp\Client([
'timeout' => 5.0,
'verify' => true,
'http_errors' => false,
]);
$response = $client->get('https://httpbin.org/get');
POST 提交表单或 JSON 的写法差异
传数据不是拼 URL 或手动设 header，Guzzle 会根据参数类型自动处理 Content-Type：
- 表单提交（
application/x-www-form-urlencoded）：用form_params键 - JSON 提交（
application/json）：用json键，Guzzle 自动序列化 + 设 header - 传原始字符串或文件：用
body键，此时需手动设headers
错例：json 和 form_params 同时出现 → 后者被忽略，且不报错
对例：
// 表单
$client->post('https://httpbin.org/post', ['form_params' => ['key' => 'value']]);
// JSON
$client->post('https://httpbin.org/post', ['json' => ['key' => 'value']]);
调试时怎么看到真实请求和响应
别靠 var_dump($response->getBody()) 猜，Guzzle 提供中间件日志，但最简方式是启用内置 debug 选项：
- 加
'debug' => true到 Client 构造参数，会输出 cURL 命令行等底层信息（含完整 header） - 注意：这个输出是直接打到 stdout 的，CLI 下可见，Web 环境要看错误日志或用 ob_start 捕获
- 更稳的调试法：用
$response->getHeaders()和$response->getStatusCode()先确认基础字段，再读 body
真实项目里，debug => true 必须关掉，它会泄露敏感 header（如 Authorization）到日志。
