ThinkPHP6如何连接PostgreSQL？_ThinkPHP6连接PG数据库指南【兼容】-ThinkPHP-PHP中文网

thinkphp6连接postgresql需避开三大陷阱：删掉'charset'=>'utf8'（pg不识别）、显式配置'hostport'=>5432（docker中hostname填容器名而非localhost）、必须设置'params'=>[pdo::attr_errmode=>pdo::errmode_exception]，否则pg错误被静默吞掉；同时确认php已加载pdo_pgsql扩展且pg_hba.conf放行连接。

thinkphp6如何连接postgresql？_thinkphp6连接pg数据库指南【兼容】

ThinkPHP6 连接 PostgreSQL 能跑通，但默认配置下大概率会卡在 PDO::ATTR_ERRMODE 静默失败、pg_hba.conf 拒绝连接、或 charset=utf8 触发构造异常这三个地方。不是 TP 本身不支持，而是 PG 的协议细节和 TP 的默认假设存在错位。

确认 PHP 已加载 pdo_pgsql 扩展

没这个扩展，后面全白搭。不能只看 php -m | grep pgsql，得验证 PDO 是否真正识别到驱动：

运行 php -r "print_r(PDO::getAvailableDrivers());"，输出里必须含 "pgsql"
Windows 下检查 php.ini 是否启用两行：extension=php_pdo_pgsql.dll 和 extension=php_pgsql.dll
Linux/macOS 检查 extension=pdo_pgsql.so，并确认 pdo.so 在它之前加载
Docker 环境里，镜像需显式安装 php-pgsql 包（如 apk add php82-pgsql），不是只装 postgresql-client

database.php 中的 pgsql 配置必须避开三个典型陷阱

TP6 的 database.php 配置看着简单，但几个键值一错就连接失败，且错误信息极不友好：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

'type' => 'pgsql' 必须小写，写成 Pgsql 或 PGSQL 会 fallback 到 MySQL 驱动
删掉 'charset' => 'utf8' —— PostgreSQL 不认这个参数，PDO 构造时直接抛 InvalidArgumentException，TP 会吞掉原始异常，只报空 QueryException
'hostport' 必须显式写，哪怕用默认 5432；Docker 场景下 'hostname' 填容器名（如 db），不能填 localhost（那是指 PHP 容器自己）
加 'params' => [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]，否则 PG 报错（比如 schema 不存在、权限不足）时 TP 只返回空结果，debug 成本翻倍

PostgreSQL 侧必须放行连接请求

TP6 配置全对，依然连不上？八成是 PostgreSQL 拦在了 pg_hba.conf。常见现象是报错：FATAL: no pg_hba.conf entry for host "x.x.x.x", user "xxx", database "xxx"

编辑 PostgreSQL 的 pg_hba.conf（通常在 /var/lib/postgresql/data/pg_hba.conf 或 C:\Program Files\PostgreSQL\x.x\data\pg_hba.conf）
在 # IPv4 local connections: 后新增一行：host all all 0.0.0.0/0 md5（开发环境），生产环境请精确到应用服务器 IP 段
确认 postgresql.conf 中 listen_addresses = 'localhost,172.x.x.x'（Docker 网络需监听宿主或网桥地址），不能只留 'localhost'
改完执行 pg_ctl reload 或重启 PostgreSQL 服务，SELECT * FROM pg_hba_file_rules(); 可验证规则是否生效

TP6 操作 PG 13+ 时字段默认值报错怎么办

用 TP6 查询表结构（比如调用 Db::query('SHOW TABLES') 或模型首次实例化）时，若 PostgreSQL 版本 ≥13，可能遇到：ERROR: column pg_attrdef.adsrc does not exist

这是 TP6 内置的 pgsql.sql 元数据查询脚本未适配 PG 13+ 导致的，adsrc 字段已被移除
临时绕过：在 config/database.php 的连接配置中加 'deploy' => 0（禁用部署模式，跳过部分元数据探测）
根治方案：升级到 ThinkPHP 6.3+（已修复），或手动补丁——将 vendor/topthink/think-orm/src/db/connector/Pgsql.php 中相关 SQL 改为用 pg_get_expr(adbin, adrelid) 替代 adsrc
注意：此问题不影响基础 CRUD，只影响自动获取字段类型、默认值等高级功能