guzzle安装失败主因是环境不满足：php版本过低（7.1需退至6.5.x）或缺失curl/json/mbstring扩展；依赖冲突时用composer why-not排查；guzzle 8构造函数类型校验更严，headers不再自动合并；vendor/bin/guzzlehttp-guzzle仅为composer生成的空脚本，无实际功能。
composer require guzzlehttp/guzzle 装不上？先看 PHP 版本和扩展
装不上 guzzlehttp/guzzle，八成不是命令写错，而是环境不满足。Guzzle 7.x 要求 PHP ≥ 7.2.5，且必须启用 curl 扩展；Guzzle 8.x 起要求 PHP ≥ 7.2.5（但推荐 ≥ 8.0），还依赖 json 和 mbstring。用 php -v 和 php -m | grep -E "curl|json|mbstring" 快速确认。
- 如果
curl没启用，Docker 用户常漏掉docker-php-ext-install curl；Mac M1 用户用 Homebrew 装 PHP 可能默认不带 curl，得重装带扩展的版本 - PHP 7.1 或更低？只能退到 Guzzle 6.5.x：
composer require guzzlehttp/guzzle:^6.5 - 用的是阿里云函数计算、Serverless 平台？部分环境禁用
curl，Guzzle 直接不可用，得换file_get_contents+ stream context 方案
为什么 composer require 后 vendor/guzzlehttp/ 下没文件？
常见于项目已存在 composer.lock 且锁定了冲突依赖，或 minimum-stability 设置太严。Composer 不会强行覆盖锁定版本，也不会自动降级解决冲突。
- 运行
composer why-not guzzlehttp/guzzle:7.9.2（替换成你想装的具体版本）查阻塞来源 - 临时放宽稳定性：加
--stability=stable参数，或在composer.json中设"minimum-stability": "stable" - 锁文件干扰最典型场景：项目里已有
symfony/http-client且版本较新，它和 Guzzle 的psr/http-message版本要求打架，此时要么统一用一个 HTTP 客户端，要么手动指定兼容版本如composer require guzzlehttp/guzzle:^7.5.0
Guzzle 7 和 Guzzle 8 的 Client 构造差异直接影响代码是否报错
升级到 Guzzle 8 后，GuzzleHttp\Client 构造函数不再接受关联数组直接传参，必须用 array 包裹进 ['base_uri' => '...'] 这种形式 —— 表面只是语法微调，但旧代码直接运行会抛 TypeError。
- Guzzle 7 写法：
$client = new \GuzzleHttp\Client(['base_uri' => 'https://api.example.com']); - Guzzle 8 写法：
$client = new \GuzzleHttp\Client(['base_uri' => 'https://api.example.com']);（看起来一样，但内部类型检查更严，空数组或 null 会被拒绝） - 真正容易翻车的是
headers：Guzzle 8 不再自动合并默认 header，如果之前靠全局设User-Agent，现在得显式传或用withHeader() - 异步请求中
Promise的 resolve/reject 行为也有调整，wait()在某些超时场景下可能提前 throw，不能只捕获RequestException
vendor/bin/guzzlehttp-guzzle 是什么？别误当成可执行命令
这个文件是 Composer 自动生成的 bin 脚本入口，**不是 Guzzle 提供的 CLI 工具**。它只是个空壳，指向类加载器，实际没有任何功能。网上搜到的 “用 guzzlehttp-guzzle 发请求” 都是误导。
- 想快速测试 HTTP 请求？直接写个
test.php：<?php require 'vendor/autoload.php'; $c = new \GuzzleHttp\Client(); echo $c->get('https://httpbin.org/get')->getBody(); ?> - 需要命令行调试？用
curl或httpie更直接；非要 PHP CLI 脚本，就自己写，别指望那个guzzlehttp-guzzle文件 - 有些 IDE 在 vendor/bin 下标亮它，让人以为是工具，其实只是 Composer 的符号链接残留，删了也不影响 Guzzle 运行
timeout 和 connect_timeout 在不同 PHP-curl 版本下行为不一致，这种细节不会报错，但会让超时逻辑在生产环境突然失效。
