直接用 composer require guzzlehttp/guzzle 即可安装最新稳定版v7.x，无需额外配置；常见问题包括网络无法访问Packagist、PHP版本不兼容、autoload未引入及cURL证书路径缺失。
直接用 composer require guzzlehttp/guzzle 就行
不需要额外配置或手动下载，Composer 会自动拉取最新稳定版（目前是 v7.x），并处理依赖、生成自动加载规则。只要项目根目录有 composer.json（哪怕空文件），命令就能正常执行。
常见错误现象：Could not find package guzzlehttp/guzzle —— 大概率是网络连不上 Packagist 官方源，不是命令写错了。
- 国内用户建议先执行
composer config -g repo.packagist composer https://packagist.phpcomposer.com（已停用）或改用阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 如果项目锁定了 PHP 版本（比如
"php": "^7.4"），而你本地是 PHP 8.2，composer require可能因版本约束失败，这时看报错里具体哪条 constraint 不满足，再决定是否加--with-all-dependencies或降级 Guzzle 版本 - Guzzle v7 要求 PHP >= 7.2.5；v8 要求 PHP >= 8.0 —— 别硬装高版本，否则
composer install时会卡在 autoload 生成阶段
安装指定版本：看清 guzzlehttp/guzzle 的版本号语义
Guzzle 的主包版本和实际行为强相关，不是“越新越好”。v7 和 v8 是两个不兼容的大版本，API 差异大到连 new \GuzzleHttp\Client() 后的调用方式都可能报错。
- 要兼容老项目或 Laravel 8/9？用
composer require guzzlehttp/guzzle:^7.5（v7 最后一个功能更新版） - 新项目且确定用 PHP 8+？可上
composer require guzzlehttp/guzzle:^8.0，但注意Promise接口、中间件注册方式、默认超时单位全变了 - 别写
^7.0然后指望它自动升到 v8 —— Composer 的 ^ 规则不会跨主版本，这是很多人误以为“升级了”其实没升的原因
装完没反应？检查 vendor/autoload.php 是否被正确引入
Guzzle 不是“装完就全局可用”的扩展，它走的是 PSR-4 自动加载。如果 require 'vendor/autoload.php'; 没执行，或者路径写错，new \GuzzleHttp\Client() 会直接报 Class 'GuzzleHttp\Client' not found。
立即学习“PHP免费学习笔记（深入）”；
- 确认入口脚本（比如
index.php）第一行是require __DIR__ . '/vendor/autoload.php';，而不是相对路径如./vendor/autoload.php - Laravel、Symfony 等框架通常已内置加载，但如果是纯脚本或微服务 CLI 命令，必须手动引
- 运行
composer dump-autoload可强制重建映射，适合改过composer.jsonautoload 配置后
为什么 curl_setopt_array(): CURLOPT_SSL_VERIFYPEER 报错？不是 Guzzle 的锅
这个错误常出现在 Windows 或某些 Docker 环境，本质是 cURL 找不到 CA 证书路径，和 Guzzle 无关。Guzzle v7 默认开启 SSL 验证，一碰 HTTPS 就崩。
- 临时解决（仅开发）：创建 Client 时关验证：
new \GuzzleHttp\Client(['verify' => false])，但别提交到生产 - 正解是配对证书路径：
new \GuzzleHttp\Client(['verify' => '/path/to/cacert.pem'])，证书文件可从 curl 官网下载 - 更省事的办法：把证书放项目下（如
resources/cacert.pem），然后在 Composer 的autoload.files里预加载一次，避免每次 new Client 都传路径
