ThinkPHP配置GaussDB数据库：华为高斯数据库在ThinkPHP中的驱动适配指南-ThinkPHP-PHP中文网

thinkphp 连 gaussdb 必须用 pgsql 驱动并配置 schema 和 hostport；type 只能设为 pgsql，需启用 pdo_pgsql 和 pgsql 扩展，charset 推荐 utf8，密码需 urlencode，ssl 连接建议先禁用排查。

thinkphp配置gaussdb数据库：华为高斯数据库在thinkphp中的驱动适配指南

ThinkPHP 直接用 pgsql 驱动就能连 GaussDB，但必须改两处关键配置，否则会报 SQLSTATE[08006] [7] FATAL: database "xxx" does not exist 或 invalid value for parameter "client_encoding" —— 这不是数据库不存在，是 GaussDB 默认 schema 和编码协商机制和标准 PostgreSQL 不一致。

ThinkPHP 的 `type` 必须设为 `pgsql`，不能写 `gaussdb`

ThinkPHP 框架本身不内置 GaussDB 驱动，也不识别 type => 'gaussdb'。它只认官方支持的驱动类型：mysql、pgsql、sqlsrv 等。GaussDB 基于 openGauss，而 openGauss 兼容 PostgreSQL 协议，所以必须走 pgsql 路线。

常见错误：

把 type 写成 gaussdb 或 opengauss，导致框架 fallback 到 mysql 驱动，连接时直接抛出 Call to undefined function mysql_connect()（PHP 8+ 已移除）
误以为要装额外扩展，其实只要系统已启用 pdo_pgsql 和 pgsql 扩展即可

验证方式：

php -m | grep pgsql

应输出：pdo_pgsql 和 pgsql（缺一不可）

`database.php` 中必须显式指定 `schema` 和 `hostport`

GaussDB 默认 schema 是 public，但部分企业版或信创部署会预设为 gaussdb 或自定义 schema；同时，GaussDB 官方推荐端口是 26000（非 PostgreSQL 默认 5432），不显式写 hostport 就会连错端口或触发连接超时。

正确配置示例（config/database.php）：

btpanel phpsite 宝塔面板PHP网站

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

下载

return [
    'type'        => 'pgsql',
    'hostname'    => '192.168.10.5',
    'hostport'    => '26000',
    'database'    => 'myapp',
    'username'    => 'app_user',
    'password'    => 'Secure@2026',
    'charset'     => 'utf8',
    'prefix'      => '',
    'schema'      => 'public', // 必填！尤其当 GaussDB 实例初始化时指定了非 public schema
    'debug'       => true,
];

注意点：

schema 键名必须小写，ThinkPHP 6.1+ 才支持该配置项；低于此版本需在 DSN 中拼接：pgsql:host=...;port=26000;dbname=myapp;user=...;password=...;options=--search_path=public
charset 设为 utf8 更稳妥，utf8mb4 在 GaussDB 早期版本中可能触发 invalid value for parameter "client_encoding"
若使用 SSL 连接，需额外加 'sslmode' => 'require'，且确保 PHP 编译时启用了 OpenSSL

DSN 方式连接时，必须 urlencode() 密码中的特殊字符

ThinkPHP 支持 DSN 字符串直连，但 GaussDB 用户密码常含 @、/、: 等符号（如 Gauss@2026#prod），不编码会导致解析失败，表现为连上却查不到库，或直接报 Parse error: invalid DSN。

正确做法：

用 urlencode() 包裹密码（用户名同理）
DSN 格式严格为：pgsql://username:password@hostname:port/database#charset
端口不可省略，即使连的是 5432 —— GaussDB 多数生产环境不用默认端口

示例代码：

$dsn = 'pgsql://' . urlencode('admin') . ':' . urlencode('Gauss@2026#prod') . '@192.168.10.5:26000/myapp#utf8';
$db = Db::connect($dsn);

遇到 `SSL connection failed` 或证书校验失败时，优先关 SSL 再定位问题

GaussDB 信创部署常强制开启 SSL，但 ThinkPHP 的 PDO_PGSQL 层对 sslrootcert、sslcert 等参数无透传支持，直接配进 DSN 或 config 会被忽略。强行开启易卡在握手阶段。

建议排查路径：

先临时关闭 SSL：'sslmode' => 'disable'，确认基础连通性
连通后，再通过 PDO::ATTR_ERRMODE 开启异常捕获，看真实错误是否来自证书路径或权限
如确需 SSL，改用原生 PDO 构造连接，绕过 ThinkPHP 封装：

$pdo = new PDO(
    'pgsql:host=192.168.10.5;port=26000;dbname=myapp;sslmode=verify-full;sslrootcert=/path/to/root.crt',
    'admin',
    'pass',
    [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
);

复杂点在于：GaussDB 的 SSL 配置高度依赖部署形态（集中式/分布式）、华为云 Stack 版本、以及是否启用双向认证 —— 这些细节没法靠一个 sslmode=require 统一解决。