ThinkPHP 连 GaussDB 必须用 pgsql 驱动并配置 schema 和 hostport；type 只能设为 pgsql，需启用 pdo_pgsql 和 pgsql 扩展，charset 推荐 utf8，密码需 urlencode，SSL 连接建议先禁用排查。
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免费学习笔记（深入）”；
php -m | grep pgsql
应输出：pdo_pgsql 和 pgsql（缺一不可）
database.php 中必须显式指定 schema 和 hostport
GaussDB 默认 schema 是 public，但部分企业版或信创部署会预设为 gaussdb 或自定义 schema；同时，GaussDB 官方推荐端口是 26000（非 PostgreSQL 默认 5432），不显式写 hostport 就会连错端口或触发连接超时。
正确配置示例（config/database.php）：
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 统一解决。
