Guzzle 是 HTTP 客户端，不能连接数据库；数据库操作应使用 PDO、mysqli 或 ORM。它仅用于调用外部或内部 REST API，如微信 token 接口；混淆二者会导致协议错误与排查困难。
PHP 里用 Guzzle 调用 API 和数据库操作完全无关 —— 不要试图“用 Guzzle 连数据库”。Guzzle 是 HTTP 客户端，只负责发请求、收响应；数据库连接靠 mysqli、PDO 或 ORM（如 Laravel 的 Eloquent）。混淆这两者会导致连基础错误都排查不清。
为什么 Guzzle 不能连数据库
Guzzle 底层走的是 HTTP 协议，而 MySQL/PostgreSQL 等数据库用的是自定义二进制协议（如 MySQL 的 TCP 3306 端口），不接受 HTTP 请求。你用 Guzzle 去请求 http://localhost:3306，只会得到连接拒绝或空响应，不是认证失败，是协议根本不通。
常见误操作包括：
- 把数据库连接字符串（如
mysql:host=localhost;dbname=test）当成 URL 传给GuzzleHttp\Client::request() - 试图用
POST /login模拟数据库登录，却没后端 API 接口支撑 - 看到 “API” 就默认要用 Guzzle，忽略了项目里其实已有封装好的数据库类
什么时候该用 Guzzle
当你需要从 PHP 后端主动调用外部服务（或自己写的 REST API）时才用 Guzzle，典型场景有：
立即学习“PHP免费学习笔记（深入）”；
- 调用微信公众号
https://api.weixin.qq.com/cgi-bin/token获取 access_token - 对接支付网关，如向支付宝沙箱
https://openapi.alipaydev.com/gateway.do发起请求 - 读取第三方天气 API：
https://api.openweathermap.org/data/2.5/weather?q=Beijing
注意：这些 URL 必须是真实可访问的 HTTP(S) 地址，且返回 JSON/XML —— 不是本地数据库 socket 文件路径，也不是 127.0.0.1:5432 这类数据库端口。
正确连数据库该用什么
直接使用 PHP 原生扩展或现代抽象层：
- MySQL：用
PDO（推荐）或mysqli，例如：$pdo = new PDO('mysql:host=localhost;dbname=test', $user, $pass); - PostgreSQL：
PDO配pgsql:host=localhost;dbname=test - Laravel 项目：用
DB::table('users')->get()，底层仍是 PDO - 若你真想“通过 API 访问数据库”，那得先写一个 Web API 层（比如用 Laravel/Slim 暴露
/api/users），再用 Guzzle 调这个 API —— 但这是两层架构，Guzzle 连的是你的 API，不是数据库本身
如果非要“Guzzle + 数据库协作”，怎么设计
这是合理需求：比如前端提交表单 → PHP 后端用 Guzzle 调鉴权服务 → 鉴权通过后再查本地数据库。关键点是职责分离：
- Guzzle 只管网络调用，超时设
timeout: 5，错误必须 try/catchGuzzleHttp\Exception\RequestException - 数据库操作独立事务，别塞在 Guzzle 回调里做 commit
- 避免在循环里反复 new
GuzzleHttp\Client，复用实例或用 DI 容器管理 - 敏感数据（如 API token）不要硬编码在
new Client(['headers' => [...]])里，从环境变量读取
真正容易被忽略的是错误传播链：Guzzle 超时可能被误判成数据库慢，日志里没区分来源，结果花半天查错方向。
