Guzzle 能否正常使用取决于 PHP 版本、cURL 扩展、CA 证书及 autoloader 配置；需确认 PHP ≥7.2.5（7.x）或 ≥8.0（8.x），启用 ext-curl，正确引入 autoload.php，设置 verify 选项或 curl.cainfo。
直接用 composer require guzzlehttp/guzzle 就能装上，但实际项目中常因 PHP 版本、cURL 配置或 autoloader 加载失败导致请求报错——关键不在“装没装”，而在“能不能用”。
确认 PHP 环境是否满足 Guzzle 最低要求
Guzzle 7.x 要求 PHP ≥ 7.2.5；Guzzle 8.x 起强制要求 PHP ≥ 8.0。低于对应版本会触发 ParseError 或 Class 'GuzzleHttp\Client' not found。
- 运行
php -v查看当前版本 - 查看
composer.json中已声明的"php"约束（如"^8.0"），确保与系统一致 - 若用的是旧版 PHP（如 7.1），只能降级安装 Guzzle 6.5：
composer require guzzlehttp/guzzle:^6.5
安装后无法 new Client()？检查 autoloader 和命名空间
常见错误是写了 new GuzzleHttp\Client() 却提示类不存在，本质是未引入自动加载器或命名空间写错。
- 确保脚本开头有
require 'vendor/autoload.php';（路径需准确，比如在项目根目录执行） - 类名必须带完整命名空间：
GuzzleHttp\Client，不能简写为Client或Guzzle\Client - 如果用了 PSR-4 自动加载，确认
composer.json中没有覆盖或误删"autoload": {"psr-4": {...}}块
cURL 扩展未启用会导致 request() 直接失败
Guzzle 默认使用 cURL 作为传输层，若 ext-curl 未启用，运行时会抛出 RuntimeException: cURL extension is required。
立即学习“PHP免费学习笔记（深入）”；
- Linux/macOS：运行
php -m | grep curl，无输出说明未启用 - Windows：检查
php.ini中是否取消了;extension=php_curl.dll的注释 - Docker 用户注意：基础镜像（如
php:8-cli）默认不含 cURL，需加装：RUN apt-get update && apt-get install -y libcurl4-openssl-dev && docker-php-ext-install curl
HTTPS 请求失败？别急着换 HTTP，先检查 CA 证书配置
访问 HTTPS 接口时报 cURL error 60: SSL certificate problem，不是 Guzzle 问题，而是 PHP/cURL 找不到可信 CA 证书路径。
- 临时方案（仅开发）：禁用证书验证（不推荐上线）：
$client = new \GuzzleHttp\Client(['verify' => false]);
- 生产推荐：下载最新 CA 包，设置
curl.cainfo（PHP 配置）或 Guzzle 的verify选项指向本地路径：$client = new \GuzzleHttp\Client(['verify' => '/etc/ssl/certs/ca-certificates.crt']);
- Mac M1 用户常见坑：Homebrew 安装的 PHP 可能默认找不到系统证书，建议用
brew install ca-certificates并更新 php.ini
真正卡住人的往往不是“怎么装”，而是环境细节没对齐：PHP 小版本、cURL 是否就绪、CA 路径是否可读、autoload 是否生效——这些地方一错，new Client() 就静默失败或报错模糊。
