Guzzle 7.5 是 PHP 7.2+ 项目最稳选择，应显式安装 ^7.5 版本以避免与 PSR v1 冲突；需设 timeout 和 verify，慎用 getContents()，区分 form_params/json/multipart，务必校验状态码与 Content-Type。
直接装 guzzlehttp/guzzle:^7.5，别碰默认无版本号的命令
PHP 7.2+ 项目现在最稳的选择就是 Guzzle 7.5 系列，它兼容广泛、生态成熟、文档齐全，且不会像 Guzzle 8 那样强制要求 psr/http-factory 和 psr/http-message v2，避免和老项目里残留的 guzzlehttp/psr7 v1 冲突。
- 运行
composer require guzzlehttp/guzzle:^7.5—— 这会装 7.5.x 最新版（如 7.5.2），但绝不会升到 8.x - 如果项目还卡在 PHP 7.1，只能退到
guzzlehttp/guzzle:6.5.5（LTS 终止维护了，仅限救急） - 千万别只敲
composer require guzzlehttp/guzzle—— Composer 默认拉最新 major 版（目前是 8.x），极易引发Class not found: Psr\Http\Message\RequestFactoryInterface这类 PSR 类加载失败 - 国内用户顺手配镜像源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，否则大概率卡在Downloading guzzlehttp/guzzle
发 GET 请求前，先检查 verify 和 timeout 是否设对
90% 的“请求卡死”或“cURL error 60”不是网络问题，而是 SSL 验证失败或没设超时。Guzzle 7 默认开启证书校验，但本地开发环境常缺 CA bundle 路径。
-
timeout必须显式设，比如['timeout' => 5.0]；不设的话默认是 0（无限等待），一遇丢包就 hang 死 - 开发时遇到
cURL error 60: SSL certificate problem，临时加'verify' => false即可，但生产环境必须删掉，改用'verify' => '/path/to/cacert.pem' - 别依赖
file_get_contents()或裸curl_init()封装——它们不自动处理重定向、不统一异常类型、JSON 解析前也不校验Content-Type - 示例写法：
$client = new \GuzzleHttp\Client(['timeout' => 5.0, 'verify' => false]); $res = $client->get('https://httpbin.org/get');
$response->getBody()->getContents() 不是万能的，大响应体要小心内存
这个链式调用看着方便，但它会把整个响应体一次性读进内存。调用返回 10MB JSON 或图片流时，PHP 进程可能直接 OOM，尤其在 CLI 或低配容器里。
- 如果是小数据（json_decode($res->getBody()->getContents(), true)
- 若响应体较大，改用流式处理：
$stream = $res->getBody(); while (!$stream->eof()) { echo $stream->read(8192); } - 注意
getContents()只能调一次——第二次返回空字符串，因为指针已到末尾；需要重复读请先rewind() - 别忘了检查状态码：
if ($res->getStatusCode() !== 200) { throw new RuntimeException('API returned '.$res->getStatusCode()); }
POST 表单和 JSON 数据，参数键名完全不同
很多人 POST 失败，是因为把 json 和 form_params 搞混了——Guzzle 对这两类请求做了严格区分，传错字段名服务器根本收不到数据。
- 发传统表单（
application/x-www-form-urlencoded）：用'form_params' => ['username' => 'foo', 'token' => 'bar'] - 发 JSON（
application/json）：用'json' => ['username' => 'foo', 'token' => 'bar']—— Guzzle 会自动设 header、序列化 body - 传文件用
'multipart'，不是'form_params'，也不是'json'；漏掉'contents'或'filename'字段会导致上传为空 - 错误示范：
$client->post($url, ['json' => $data, 'form_params' => $data])—— 两个同时存在会报错
