php连接postgresql失败主因是pdo_pgsql扩展未启用、dsn含charset参数（pg不支持）、pdo错误模式为静默（需设errmode_exception）；须验证pdo::getavailabledrivers()含pgsql，删charset键，docker中hostname填容器名，显式配置errmode_exception。
PHP 连接 PostgreSQL 数据库失败，八成不是密码或地址错了，而是 pdo_pgsql 扩展没加载、charset 参数误配、或 PDO 错误模式被设成静默——这三处不调对，连接看似成功，一查表就抛空异常，日志里还看不到真实报错。
确认 pdo_pgsql 扩展已启用
没这个扩展，PDO 根本不认识 pgsql 协议，所有连接都会静默失败（连错误都不报）。不能只看 php -m | grep pgsql，得验证 PDO 是否真能识别驱动：
- 运行
php -r "print_r(PDO::getAvailableDrivers());"，输出必须含"pgsql" - Linux/Debian：装
sudo apt install php-pgsql，再重启php-fpm或apache2 - Windows：检查
php.ini里这两行已取消注释：extension=php_pdo_pgsql.dll和extension=php_pgsql.dll；若提示找不到libpq.dll，需在httpd.conf加LoadFile "C:/php/libpq.dll" - MAMP 用户：Preferences → PHP → Extensions → 勾选
pgsql和pdo_pgsql，改完必须完全退出并重开 MAMP
DSN 中严禁出现 charset 参数
PostgreSQL 不支持 charset 参数。TP6/TP8 会把它塞进 DSN，导致 PDO 构造直接失败，但异常被框架吞掉，只抛出无意义的 QueryException：
- ❌ 错误写法：
'charset' => 'utf8'或'charset' => 'utf8mb4' - ✅ 正确做法：从数据库配置数组中彻底删掉
charset键，或显式设为null（TP8 会跳过） - 最终生成的 DSN 应形如：
pgsql:host=pg;port=5432;dbname=myapp;user=postgres;password=xxx—— 里面不能有charset=
Docker 环境 hostname 必须填容器名
本地用 Docker Compose 跑 PostgreSQL 时，hostname 写 localhost 一定失败——因为 PHP 进程在另一个容器里，localhost 指的是它自己，不是数据库容器：
- ✅ 正确值示例：
'hostname' => 'pg'（对应docker-compose.yml中 service 名为pg） - 端口保持
5432即可，这是容器内端口；宿主机映射的端口不影响 PHP 配置 - 连不通先验证网络：
docker exec -it your_php_container ping pg，不通就检查docker-compose.yml的networks配置
必须设置 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
默认的 PDO::ERRMODE_SILENT 会让 PostgreSQL 的真实错误（比如表不存在、字段类型不匹配、权限不足）被 TP 框架吞掉，只返回空结果或截断的异常信息：
- 在数据库配置数组中加：
'params' => [ \PDO::ATTR_ERRMODE => \PDO::ERRMODE_EXCEPTION ] - 配合
'debug' => true才能看到实际执行的 SQL 和绑定参数 - 否则你可能看到类似
SQLSTATE[XX000]: >: 7 ERROR: relation "user" does not exist这种原始报错被截断成空异常
最容易被忽略的是 charset 键和 PDO::ATTR_ERRMODE 设置——它们不会拦在连接建立阶段，却会让后续所有查询都变成“黑盒”，排查成本陡增。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
