php 7.3 可用 pdo_pgsql 直连 gaussdb 200（opengauss 内核），但须启用 pdo_pgsql 和 pgsql 扩展、dsn 显式指定 --search-path=public、密码 urlencode、删 charset 参数、设 pdo::attr_emulate_prepares => true 并禁用 ssl 排障。
PHP 7.3 可以用 PDO_PGSQL 扩展直连 GaussDB 200，前提是它运行在 PostgreSQL 兼容模式（即 openGauss 内核），不需要额外驱动或改写底层协议——但必须绕过几个关键兼容性坑。
确认 GaussDB 200 实际运行的是 openGauss 内核
GaussDB 200 有两个主要分支：基于 PostgreSQL 的 openGauss 内核（支持 pgsql 协议），和基于 MPP 架构的 GaussDB(for MySQL)（走 MySQL 协议）。PHP 7.3 连接前者才适用 PDO_PGSQL；后者必须用 PDO_MYSQL，且需开启模拟预处理。
- 查文档或问运维：确认你连的是
GaussDB 200 (openGauss)，不是GaussDB 200 (MySQL mode) - 连接测试命令：
gsql -h your-host -p 5432 -U username -d dbname能成功，说明是 PostgreSQL 协议栈 - 如果
gsql报错或提示不识别，大概率是 MySQL 模式，别硬套 pgsql 配置
PHP 7.3 必须启用 pdo_pgsql 和 pgsql 扩展
PHP 7.3 自带 PDO，但 pdo_pgsql 和底层 pgsql 是独立扩展，缺一不可。只开 pdo_pgsql 会导致 PDO::__construct(): could not find driver。
- 检查是否已启用：
php -m | grep -E "^(pdo_pgsql|pgsql)$"—— 应同时输出两行 - Ubuntu/Debian：
sudo apt install php7.3-pgsql（注意不是php7.3-pdo） - CentOS/麒麟/统信：
yum install php73-php-pgsql（包名含php73，不是php73-php-pdo） - 重启 Web 服务（
systemctl restart apache2或php-fpm）
DSN 和连接参数要绕开 GaussDB 的 schema 和编码协商缺陷
直接套用标准 PostgreSQL DSN 会报 SQLSTATE[08006] [7] FATAL: database "xxx" does not exist 或 invalid value for parameter "client_encoding"——这不是库不存在，而是 GaussDB 默认把 public schema 当作隐式前缀，且对 client_encoding=utf8 响应异常。
- DSN 中必须显式指定
options='--search-path=public'，例如：pgsql:host=127.0.0.1;port=5432;dbname=testdb;user=gauss;password=xxx;options='--search-path=public' -
charset参数无效，删掉；GaussDB 不认utf8，只接受UTF8（大写），但 PDO 会自动协商，不必手动设 - 密码含特殊字符（如
@、/）必须urlencode()，否则 DSN 解析失败 - 首次连接建议关闭 SSL：
sslmode=disable（加在 DSN 末尾），排障后再开
必须设置 PDO::ATTR_EMULATE_PREPARES => true
GaussDB 对原生预处理协议的支持不完整，尤其在字段元数据返回上容易出错，导致 $stmt->fetch() 返回空或类型错乱。这是 PHP 7.3 下最隐蔽的故障点。
- 连接时必须传入该选项：
new PDO($dsn, $user, $pass, [PDO::ATTR_EMULATE_PREPARES => true]) - 不能依赖框架默认值（Laravel/ThinkPHP 默认为 false）
- 若用 ThinkPHP，需在数据库配置中显式写：
'params' => [PDO::ATTR_EMULATE_PREPARES => true] - 性能影响极小，GaussDB 200 的查询瓶颈不在这一层
真正卡住的往往不是扩展没装，而是 DSN 里漏了 options、密码没 urlencode、或者死守 charset=utf8 硬刚编码协商。GaussDB 200（openGauss）对“标准 PostgreSQL 客户端行为”的容忍度比原生 PostgreSQL 低，得按它的脾气来适配。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
