ThinkPHP 连接 YashanDB 必须使用 PDO 驱动并指定 pgsql 协议 DSN，用户名密码需 urlencode 处理，禁用自动 schema 检测，错误捕获需开启 PDO 异常模式。
ThinkPHP 默认不内置 YashanDB 驱动，直接填 'type' => 'yashan' 会报 Class 'think\db\connector\Yashan' 找不到 —— 这不是配置写错了，是驱动压根没实现。
YashanDB 在 ThinkPHP 中必须走 PDO 通用驱动
YashanDB 兼容 PostgreSQL 协议（v12+），其 JDBC/ODBC/PDO 接口均对标 pgsql 行为。ThinkPHP 的 pdo 连接器可复用，但需手动指定 dsn 并绕过默认驱动校验。
- 不要尝试注册新驱动类（如
Yashan.php），ThinkPHP 6+ 的驱动加载机制已封闭，自定义 connector 需改核心源码，不可维护 - 必须使用
Db::connect()传 DSN 字符串，且显式指定'type' => 'pdo' - DSN 格式为：
pgsql:host=127.0.0.1;port=5432;dbname=testdb（注意：YashanDB 默认端口是5432，不是3306） - 用户名、密码不能塞进 DSN，必须单独传参，否则
PDO初始化失败
示例有效配置：
$db = Db::connect([
'type' => 'pdo',
'dsn' => 'pgsql:host=192.168.5.100;port=5432;dbname=myapp',
'username' => 'sys',
'password' => 'Yashan@123',
'charset' => 'utf8',
'params' => [
\PDO::ATTR_CASE => \PDO::CASE_NATURAL,
\PDO::ATTR_ERRMODE => \PDO::ERRMODE_EXCEPTION,
],
]);
env() 读取敏感参数时，YashanDB 的密码特殊字符必须 urlencode()
YashanDB 默认 sys 用户密码常含 @、/、: 等符号（如 Yashan@2026!），若直接拼进 DSN 或传给 username/password，PDO 会提前截断。
立即学习“PHP免费学习笔记（深入）”；
- 错误写法：
'password' => env('YAS_PASSWORD', 'Yashan@2026!')→ 连接时被解析为Yashan截断 - 正确做法：在
.env中存原始密码，PHP 层用urlencode()包裹 - 示例：
// .env YAS_USERNAME=sys YAS_PASSWORD=Yashan@2026! </li></ul><p>// database.php 中 'username' => urlencode(env('YAS_USERNAME', 'sys')), 'password' => urlencode(env('YAS_PASSWORD', 'Yashan@2026!'))不 urlencode 会导致连接报错
SQLSTATE[08006] [7] invalid connection option "2026!"—— 这是 PostgreSQL 协议解析器抛出的典型提示。
YashanDB的 schema 查询和迁移需手动适配ThinkPHP 的
schema方法（如getTables()、getTableFields()）底层依赖数据库信息视图，而YashanDB的系统表命名、字段结构与 PostgreSQL 不完全一致：-
pg_tables→ YashanDB 对应sys_tables，且需加WHERE owner = 'SYS' -
pg_attribute→ YashanDB 用sys_columns，但无atttypid字段，类型映射靠data_type字符串匹配 - 自动迁移（
php think migrate:run）会失败，因为think-migration未适配 YashanDB 的CREATE TABLE语法（如不支持IF NOT EXISTS）
临时方案：
- 关闭自动 schema 检测：
'strict' => false - 手动建表后，用
Db::query()执行原生 SQL 做字段同步 - 迁移脚本全部转为
.sql文件，用yasql -f init.sql提前执行
YashanDB 和 ThinkPHP 的衔接点不在“开箱即用”，而在协议层兼容性与错误信号的准确识别。最容易被忽略的是：YashanDB 报错信息里带中文括号（如「无效用户名」），但 PDO 默认只捕获英文部分，导致日志看不出真实原因。调试时务必加
\PDO::ATTR_ERRMODE => \PDO::ERRMODE_EXCEPTION并 catch 后打印$e->getMessage()全文。 -
