guzzle 安装失败主因是 php 版本不匹配或 composer 配置问题：需 php ≥ 7.2.5（否则用 ^6.5），检查镜像源、依赖冲突时加 --with-all-dependencies，区分 require/require-dev，确保 curl 启用，显式设置超时与 user-agent，并提交 composer.lock。
composer install guzzlehttp/guzzle 失败怎么办
常见报错是 Could not find package guzzlehttp/guzzle 或 Your requirements could not be resolved，本质不是 Guzzle 本身的问题，而是 PHP 版本或 Composer 配置不匹配。
- 确认本地 PHP 版本 ≥ 7.2.5（Guzzle 7.x 要求），用
php -v检查；低于这个版本只能装 Guzzle 6.x：composer require guzzlehttp/guzzle:^6.5 - 如果用了国内镜像但没同步最新包，临时切回官方源试试：
composer config -g repo.packagist composer https://packagist.org - 项目已有旧版
guzzlehttp/promises或psr/http-message，可能引发冲突，加--with-all-dependencies强制更新：composer require guzzlehttp/guzzle --with-all-dependencies
require 和 require-dev 的区别影响 HTTP 请求调试
选错安装方式会导致生产环境意外缺失 Guzzle，或者测试时多出一堆无关依赖。
- 线上要发 HTTP 请求（比如调支付网关、第三方 API），必须用
composer require guzzlehttp/guzzle（写入require） - 只在 PHPUnit 测试里 mock HTTP 行为，才用
composer require --dev guzzlehttp/guzzle（写入require-dev） - 误把 Guzzle 放进
require-dev后上线，会直接抛出Class 'GuzzleHttp\Client' not found
Guzzle 7 默认不带 curl 扩展提示怎么处理
安装成功但运行时报 cURL error 3: <url> malformed</url> 或更隐蔽的 Client error: `GET http://...` resulted in a `000` response，大概率是底层传输层没准备好。
- 先验证系统是否真有 cURL：
php -i | grep curl，没输出说明 PHP 编译时没启用--with-curl - Windows 用户常见问题是
php.ini里extension=php_curl.dll被注释了，取消注释并重启 Web 服务 - Linux/macOS 下如果用 Homebrew 安装 PHP，可能需要额外装
curl包：brew install curl再重装 PHP - 不想依赖 cURL？可以强制用 PHP stream：创建 Client 时传
['handler' => \GuzzleHttp\Handler\StreamHandler::class]，但不支持 HTTP/2 和连接池
为什么 new Client() 后立刻报 timeout 或 DNS 错误
不是网络问题，是 Guzzle 7+ 默认启用了严格模式和较短超时，本地开发容易踩坑。
- 默认
timeout是 0（不限时），但connect_timeout只有 1.5 秒 —— 域名解析慢一点就炸，建议显式设宽裕点：new \GuzzleHttp\Client(['connect_timeout' => 5, 'timeout' => 30]) - 如果目标域名是内网地址（如
http://api.internal），宿主机 /etc/hosts 没配，Docker 环境里还可能走错 DNS，别硬扛，加'verify' => false（仅开发）或配好extra_hosts - 某些企业网络会拦截非标准 User-Agent，Guzzle 7 默认不带，加个 header 更稳：
['headers' => ['User-Agent' => 'MyApp/1.0']]
最常被跳过的其实是 composer.lock 文件的提交 —— 不提交它，CI 构建时可能拉到不同 minor 版本的 Guzzle，行为差异藏得深，比如 Promise 取消逻辑或重定向策略变化。
