thinkphp 默认不支持虚谷数据库（xugudb），因其驱动白名单无xugu且查询构建器生成的sql（如反引号、limit语法）与虚谷兼容性差；需通过pgsql驱动“欺骗”连接，并用原生pdo手写符合虚谷语法的sql。
ThinkPHP 原生不支持虚谷数据库（XuguDB），必须手动适配 PDO 驱动并绕过默认的 MySQL/PostgreSQL 语法假设，否则会报 Driver not found: xugu 或执行 SQL 报错。
为什么 TP 默认无法连接 XuguDB
ThinkPHP 的数据库驱动体系基于预置类型（如 mysql、pgsql、sqlsrv）做硬编码判断，xugu 不在白名单中；同时其内置的查询构建器（Query Builder）生成的 SQL 依赖 MySQL 或 PostgreSQL 的语法习惯（比如反引号包裹字段、LIMIT 写法、自增主键处理），而虚谷数据库虽兼容部分 SQL-92，但关键字大小写敏感、不支持反引号、OFFSET/LIMIT 必须成对出现、无 INSERT ... ON DUPLICATE KEY UPDATE 等。
直接在 database.php 中把 'type' => 'xugu' 是无效的——TP 启动时就会因找不到驱动类崩溃。
用 PDO + 自定义 type=pgsql 暂时“骗过”TP 启动
虚谷数据库 JDBC 驱动对外暴露的是标准 JDBC URL，但其 PHP 客户端实际依赖 PostgreSQL 协议兼容层（部分版本支持 pgwire 协议）。若虚谷服务端已开启 pgwire 模式（确认方式：检查 xugu.ini 中是否配置 pgwire_port = 5432 且服务重启），可尝试复用 pgsql 驱动链路。
- 确保 PHP 已启用
pdo_pgsql扩展（php -m | grep pdo_pgsql必须有输出） - 在
database.php中设'type' => 'pgsql'，而非'xugu' -
'hostname'填虚谷 pgwire 监听地址（如127.0.0.1），'hostport'填对应端口（如5432） -
'database'、'username'、'password'按虚谷实际账号填写 - 务必删掉
'charset'配置项——虚谷不认这个参数，设了反而触发连接失败
这样能跑通基础连接和简单 SELECT/INSERT，但后续遇到 ORDER BY ? OFFSET ? LIMIT ? 这类 TP 自动生成的分页 SQL 仍可能报错，因为虚谷要求 OFFSET 和 LIMIT 字面量不能为占位符（即不支持预编译绑定）。
绕过 Query Builder，手写 SQL + 原生 PDO 调用
一旦涉及分页、复杂 JOIN 或字段别名含关键字（如 order、user），强烈建议放弃 TP 的 Db::table()->where()->select() 链式调用，改用原生 PDO 方式：
- 通过
Db::getPdo()获取底层 PDO 实例 - 手写符合虚谷语法的 SQL：字段名不用反引号，用双引号（如
"order_id"）；分页必须显式写数字，如LIMIT 20 OFFSET 0 - 执行前先用虚谷客户端（如
XGMigrator.jar或 DBeaver 配置虚谷驱动）验证 SQL 是否能跑通 - 注意虚谷默认将未加引号的标识符转为大写，所以
select name from user实际查的是USER表 —— 建表时若用小写名，必须全程双引号引用
示例：
use think\facade\Db;
$pdo = Db::getPdo();
$stmt = $pdo->prepare('SELECT "id", "name" FROM "user" WHERE "status" = ? ORDER BY "id" LIMIT 10 OFFSET 0');
$stmt->execute(['active']);
$result = $stmt->fetchAll();
字符集与事务行为要单独校验
虚谷数据库的字符集由服务端决定（通常为 UTF-8），但客户端连接时不协商编码，TP 的 charset 参数无效；更关键的是事务控制：
- 虚谷默认事务隔离级别是
READ COMMITTED，但不支持SET TRANSACTION ISOLATION LEVEL语句，TP 若自动发这条命令会报错 -
max_trans_modify = 0在xugu.ini中需确认——若设为非零值，大批量INSERT可能被截断，TP 的批量写入方法（如Db::insertAll()）会静默失败 - 虚谷不支持 savepoint，因此 TP 的嵌套事务（
startTrans→savepoint）会直接抛异常
真正落地时，不要指望“一套配置走全国产库”。虚谷的 SQL 兼容性介于 PostgreSQL 和 Oracle 之间，但驱动层空缺是硬伤——最稳的路径是：关闭 Query Builder，用 PDO 原生写，每条 SQL 都在虚谷客户端里先跑一遍。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
