如何配置ThinkPHP使用PostgreSQL数据库_驱动安装与PDO连接字符串解析-ThinkPHP-PHP中文网

postgresql驱动未生效主因是php缺pdo_pgsql扩展，linux需安装php-pgsql包，windows需启用php_pdo_pgsql.dll；tp配置须设type为pgsql、hostname为127.0.0.1、勿加charset；pdo错误模式必须设为pdo::errmode_exception。

如何配置thinkphp使用postgresql数据库_驱动安装与pdo连接字符串解析

PostgreSQL 驱动没装上，`pdo_pgsql` 扩展始终不生效

ThinkPHP 启动报 Driver not found: pgsql 或 Class 'PDO' not found，大概率不是 TP 配置问题，而是 PHP 环境缺扩展。Linux 下常漏掉 php-pgsql 包；Windows 则容易只改了 php.ini 但没开对那个 extension=php_pdo_pgsql.dll 行——注意不是 php_pgsql.dll，少 pdo_ 前缀就白配。

验证方式很简单：php -m | grep pdo 看输出里有没有 pdo_pgsql；或者写个 phpinfo() 页面搜关键词。没出现就别往下调配置了。

Ubuntu/Debian：运行 sudo apt install php-pgsql，然后重启 PHP-FPM 或 Apache
CentOS/RHEL：用 sudo yum install php-pgsql（或 dnf），确认 PHP 版本匹配（如 php81-php-pgsql）
Windows：检查 php.ini 中 extension_dir 路径是否正确，且 extension=php_pdo_pgsql.dll 这行前面没被 ; 注释

ThinkPHP 的 `database.php` 里怎么填 PostgreSQL 连接参数

TP6/TP7 的数据库配置不能照搬 MySQL 写法。PostgreSQL 对端口、数据库名、用户名更敏感，而且不支持 charset 参数（字符集由服务端控制，客户端设了也无效）。

关键点是 type 必须为 pgsql，hostname 和 database 不能为空，host 不要写成 localhost——它会走 Unix socket，而默认 PostgreSQL 只监听 127.0.0.1。直接写 127.0.0.1 更稳。

'default' => [
    'type'     => 'pgsql',
    'hostname' => '127.0.0.1',
    'database' => 'myapp',
    'username' => 'postgres',
    'password' => 'xxx',
    'hostport' => '5432',
    'prefix'   => '',
]

hostport 默认是 5432，但如果改过 PostgreSQL 的 postgresql.conf，必须显式写对
不要加 'charset' => 'utf8' —— PG 不认这个，加了反而可能触发 PDO 构造失败
如果用 Docker，hostname 得填容器名（如 db），不是 localhost

`PDO::ATTR_ERRMODE` 设错导致错误静默或异常中断

PostgreSQL 报错时，如果 PDO 没设好错误模式，TP 可能吞掉真实错误信息，只抛出空 QueryException，查半天发现是权限或 schema 不存在。

ThinkPHP 默认已设 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，但如果你手动 new PDO 或改过底层连接逻辑，就得自己补上。否则 PG 的 NOTICE（比如隐式类型转换警告）会被忽略，而某些致命错误（如序列不存在）可能只返回 false 而不抛异常。

确认 think\db\connector\Pgsql 类中 connect 方法里是否含 $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION)
若自定义连接，务必在 new PDO() 后立刻设置，顺序不能错：先连上，再设属性
PG 的 standard_conforming_strings = on 是默认值，不必在 DSN 里重复写 options='--client_encoding=UTF8'，TP 已自动处理

连接字符串（DSN）里哪些参数真有用，哪些纯属干扰

很多人往 DSN 里塞一堆参数，比如 options='--client_encoding=UTF8'、sslmode=require，结果连不上还怀疑驱动。其实 ThinkPHP 的 Pgsql 连接器会自动拼基础 DSN，你只需要管好配置数组里的字段，其他靠它兜底。

真正需要干预的只有三种情况：SSL 连接、自定义 search_path、超时控制。其余像 charset、application_name（除非监控强依赖）都非必需。

SSL 连接：加 'params' => [PDO::ATTR_SSL_MODE => 'require']，而不是塞进 DSN 字符串
指定 schema：在查询前执行 SET search_path TO my_schema，或在配置里加 'execute' => ['SET search_path TO my_schema']
连接超时：用 'params' => [PDO::ATTR_TIMEOUT => 5]，单位秒；PG 自身的 connect_timeout 参数在 DSN 里无效，PHP PDO 不解析它

复杂点在于 PostgreSQL 的权限模型和 schema 分离比 MySQL 严得多。连得上不代表能查——public schema 权限、用户默认 schema、甚至表名大小写（双引号包裹才区分）都可能让一个 Db::table('user') 直接报 relation "user" does not exist。这些不在连接层解决，得回数据库里逐条核对。