ThinkPHP配置华为云GaussDB(for openGauss)：开源数据库在ThinkPHP中的驱动替换与认证方式修改-ThinkPHP-PHP中文网

pdo_mysql 连 gaussdb(for opengauss) 必然失败，因其内核基于 postgresql，不兼容 mysql 协议，握手即被拒；必须改用 pdo_pgsql 扩展，配置 type=>'pgsql'，启用 scram-sha-256 认证（php≥8.0），并适配 sql 语法。

thinkphp配置华为云gaussdb(for opengauss)：开源数据库在thinkphp中的驱动替换与认证方式修改

ThinkPHP 默认用 PDO_MYSQL 扩展连 GaussDB(for openGauss) 会失败，不是因为连不上，而是协议和行为不匹配——GaussDB(for openGauss) 内核基于 PostgreSQL，不能走 MySQL 驱动；必须切换为 PDO_PGSQL，并改用 PostgreSQL 认证方式（如 scram-sha-256）。

为什么 PDO_MYSQL 连 GaussDB(for openGauss) 必然失败

GaussDB(for openGauss) 虽然名字带 “MySQL” 的变体（如 GaussDB(for MySQL)），但 GaussDB(for openGauss) 是另一条技术路线：它内核源自 PostgreSQL 9.2.4，完全不兼容 MySQL 协议。用 PDO_MYSQL 去连，PDO 底层发的是 MySQL 二进制协议包，GaussDB 直接拒绝连接，报错通常是：

SQLSTATE[08006] [7] FATAL:  unsupported frontend protocol 1234.5679: server supports 2.0 to 3.0

这不是账号密码错，也不是网络不通，是协议握手阶段就被拒了。

常见误操作包括：

在 config/database.php 中照搬 MySQL 配置，只改了 hostname 和 port
以为加 'params' => [\PDO::ATTR_EMULATE_PREPARES => true] 就能救活（这招对 GaussDB(for MySQL) 有效，对 GaussDB(for openGauss) 完全无效）
没装 pdo_pgsql 扩展，却在配置里写 'type' => 'pgsql'，导致 ThinkPHP 启动时报 Driver [pgsql] not supported

ThinkPHP 6.x 正确配置 PDO_PGSQL 连 GaussDB(for openGauss)

必须确认三点：扩展已启用、驱动类型设对、连接参数适配 PostgreSQL 协议。

先验证 PHP 已加载 pdo_pgsql：php -m | grep pgsql 应输出 pdo_pgsql 和 pgsql
在 config/database.php 中把数据库类型从 'type' => 'mysql' 改为 'type' => 'pgsql'
'hostname' 填 GaussDB 实例的内网地址（如 gaussdb-opengauss-xxxxxx.gaussdb.rds.huaweicloud.com），'port' 一般为 5432（不是 3306）
'database' 填创建实例时指定的数据库名（默认是 postgres，但生产环境建议新建专用库）
'username' 和 'password' 必须是 GaussDB 创建的用户，且该用户需有对应库的 CONNECT 和 USAGE 权限
不需要、也不能加 PDO::MYSQL_ATTR_INIT_COMMAND 或 PDO::ATTR_EMULATE_PREPARES —— 这些是 MySQL 特有参数，PostgreSQL 驱动不识别，写了反而触发警告或忽略

GaussDB(for openGauss) 的密码认证方式必须匹配

华为云 GaussDB(for openGauss) 默认开启 scram-sha-256 密码加密认证，而旧版 PHP（如 7.4 及更早）的 pdo_pgsql 不支持该方式，连接会卡在认证阶段，报错类似：

btpanel phpsite 宝塔面板PHP网站

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

下载

SQLSTATE[08006] [28000] FATAL:  password authentication failed for user "xxx"

即使密码完全正确也会失败。解决办法只有两个：

升级 PHP 到 8.0+（推荐）：8.0 起 pdo_pgsql 原生支持 scram-sha-256
降级 GaussDB 认证方式（不推荐）：通过华为云控制台 → 实例 → 参数模板 → 修改 password_encryption 为 md5，再重启实例（注意：md5 明文传输风险高，仅限测试环境）

另外，如果使用 SSL 连接（华为云强制要求生产环境开启），需在配置中加上：

'options' => 'sslmode=require sslrootcert=/path/to/server-ca.pem'

证书路径必须是绝对路径，且 PHP 进程有读取权限。

迁移时最容易被忽略的 SQL 兼容性断点

即便连接成功，ThinkPHP 自动生成的 SQL 仍可能报错，因为 GaussDB(for openGauss) 对标准 SQL 更严格：

GROUP BY 必须包含 SELECT 中所有非聚合字段（MySQL 5.7+ 也如此，但 ThinkPHP 某些链式查询会漏写）
没有 IF NOT EXISTS 语法，建表/建索引前得先查是否存在（Db::query("SELECT to_regclass('table_name')")）
datetime 类型不存在，要用 timestamp without time zone 或 timestamptz，ThinkPHP 的 auto_write_timestamp 需显式指定格式：'format' => 'Y-m-d H:i:s'
INSERT ... ON DUPLICATE KEY UPDATE 不支持，得改用 INSERT ... ON CONFLICT DO UPDATE（需自定义 query 或重写 Model 方法）