ThinkPHP 数据库配置文件 pgsql / oracle 写法【扩展】-ThinkPHP-PHP中文网

thinkphp连接postgresql必须同步满足三件事：启用php_pdo_pgsql和php_pgsql扩展、pg_hba.conf显式放行127.0.0.1/32的md5认证、hostname必须写127.0.0.1而非localhost，且配置中需删掉无效的charset参数。

thinkphp 数据库配置文件 pgsql / oracle 写法【扩展】

PostgreSQL 配置要点

ThinkPHP 连接 PostgreSQL 不是改个 type 就能通，必须同步满足三件事：

PHP 启用 php_pdo_pgsql 和 php_pgsql 两个扩展（缺一报 Fatal error: Call to undefined function pg_connect() 或 Driver not found）
PostgreSQL 的 pg_hba.conf 显式允许 127.0.0.1/32 使用 md5 认证（默认只走 Unix socket，不放行 TCP 就连不上）
ThinkPHP 配置中 hostname 必须写 127.0.0.1，不能写 localhost（否则 PDO 尝试走 socket，而多数 PG 安装不监听或路径不对）

TP6/TP7 的 config/database.php 示例：

'pgsql' => [
  'type'      => 'pgsql',
  'hostname'  => '127.0.0.1',
  'hostport'  => '5432',
  'database'  => 'your_db',
  'username'  => 'your_user',
  'password'  => 'your_pass',
  'charset'   => 'utf8', // 实际无效，PG 字符集由服务端控制，可删
  'prefix'    => '',
],

Oracle 配置要点

ThinkPHP 连接 Oracle 推荐使用原生 oci8 扩展（非 PDO），配置比 PG 更敏感，关键在 DB_NAME 写法和 DB_PARAMS：

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

DB_TYPE 设为 oracle（小写，TP3.2 支持大写 Oracle，但统一小写更稳）
DB_NAME 不是数据库名，而是完整连接描述符（tnsnames.ora 格式），例如：
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.1.100)(PORT=1521))(CONNECT_DATA=(SID=ORCL)))
DB_PARAMS 中必须包含 'persist' => true，否则连接可能不稳定或报错
DB_PORT 可填可不填，但显式写上更明确（如 1521 或 1029）

TP3.2 典型配置示例（全局数组方式）：

'DB_TYPE'   => 'oracle',
'DB_HOST'   => '192.168.1.100',
'DB_NAME'   => '(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.1.100)(PORT=1521))(CONNECT_DATA=(SID=ORCL)))',
'DB_USER'   => 'scott',
'DB_PWD'    => 'tiger',
'DB_PORT'   => 1521,
'DB_CHARSET'=> 'AL32UTF8', // Oracle 推荐用 AL32UTF8 而非 utf8
'DB_PARAMS' => ['persist' => true],

多库共存与切换

若项目同时用 pgsql 和 oracle，需在配置文件中定义多个独立连接键名：

每个连接必须有唯一、合法的键名（仅小写字母、数字、下划线，不含点号或大写）
每个连接都必须显式声明 'type'（如 'pgsql' 或 'oracle'），漏写会导致框架误用默认驱动
运行时切换用 Db::connect('pgsql_log') 或 Db::connect('oracle_report')，传入的是配置键名，不是数据库名或模型名
模型绑定连接用 protected $connection = 'oracle_report';，该值仅初始化时读取一次，不支持运行中动态变更

常见报错与速查

遇到连接失败，按顺序排查以下四类问题：

PHP 扩展缺失：Linux 执行 php -m | grep pgsql 或 php -m | grep oci8；Windows 检查 php.ini 是否启用对应 dll
PG 权限拒绝：查看 PostgreSQL 日志，若含 FATAL: no pg_hba.conf entry for host，说明 pg_hba.conf 缺少对应规则
Oracle 连接超时：确认 DB_NAME 中 HOST 和 PORT 与实际监听一致，且防火墙未拦截
字符集报错：PostgreSQL 的 charset 参数无效，删掉；Oracle 建议用 AL32UTF8，避免用 utf8

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！