ThinkPHP中废弃的数据库驱动如何迁移_适配PDO与驱动器扩展技巧

ThinkPHP 5.1+ 里 mysql 驱动为什么连不上？

因为 mysql 扩展在 PHP 7.0+ 已被移除，ThinkPHP 5.1 起也彻底废弃了 mysql 驱动类。你看到的 Class ‘mysql’ not found 或 Driver [mysql] not supported 错误，根本不是配置写错，而是驱动本身已不存在。

必须切换到 pdo_mysql，且确保 PHP 已启用 pdo 和 pdo_mysql 模块（php -m | grep pdo 可验证）。

database.php 中把 ‘type’ => ‘mysql’ 改成 ‘type’ => ‘pdo’同时补全 ‘dsn’ => ‘mysql:host=127.0.0.1;dbname=xxx;charset=utf8mb4’，不能只靠 hostname/database 等零散参数若沿用旧版自动拼接 DSN 的习惯，会因缺少 charset 导致中文乱码或连接失败

自定义 PDO 驱动时 think\db\connector\Pdo 怎么继承？

官方 Pdo 基类不直接支持多数据库类型混用（比如想让一个驱动同时处理 MySQL 和 PostgreSQL），但你可以继承它并重写 parseDsn() 和 getFields() 等关键方法。

注意：不要复制整个 Pdo.php 再改——ThinkPHP 6+ 的 think\db\connector\Pdo 是抽象基类，必须实现 initConnect()；而 TP5.1 的对应类是 think\db\connector\Mysql（已废弃）或 think\db\connector\Pdo（需手动指定 dsn）。

立即学习“PHP免费学习笔记（深入）”；

继承 think\db\connector\Pdo 后，在 __construct() 里调用 parent::__construct($config)，别漏掉parseDsn() 返回的 DSN 字符串必须含 charset，否则 execute() 执行 SQL 时可能报 SQLSTATE[HY000] [2054] The server requested authentication method unknown to the client若扩展中用了 $this->linkID->getAttribute(PDO::ATTR_SERVER_VERSION)，要加 try/catch，部分云数据库（如阿里云 RDS）返回空版本号会导致致命错误

Db::connect() 切换配置后查询仍走旧连接？

这是连接池缓存导致的——ThinkPHP 默认对相同 DSN 复用连接。即使你传入新配置数组，只要 dsn 字符串完全一致（包括空格、分号位置），就会命中已有连接。

典型场景：同一套代码连测试库和正式库，仅靠动态改 database 名，但没更新 dsn，结果查的还是旧库。

强制刷新连接：在 Db::connect($config) 后立刻调用 Db::close()，再执行查询更稳妥的做法是给每个连接配唯一标识，比如在 dsn 末尾加 ;uid=test_v2（PDO 忽略未知参数，但能破坏缓存键）TP6.0+ 支持 ‘deploy’ => 1 主从分离，但若主库配置里 dsn 相同，从库也会复用主库连接，造成事务异常

迁移后 getLastSql() 显示的 SQL 和实际执行不一致？

这是因为 PDO 预处理机制下，ThinkPHP 日志里的 getLastSql() 是绑定参数前的模板 SQL（含 ? 占位符），而真实执行的是 PDO 替换后的语句。调试时若只看这个，会误判参数是否生效。

尤其在使用 whereRaw() 或闭包查询时，占位符顺序和实际绑定值可能错位，导致 SQL 逻辑偏差。

查真实执行语句，得开 PDO 的 PDO::ATTR_EMULATE_PREPARES => false 并配合 MySQL 的 general_log（SET GLOBAL general_log = ‘ON’）TP5.1 中 think\db\Query 的 buildSql() 方法可生成完整 SQL（含参数值），但它不走预处理，仅用于调试，不能直接执行如果用了 bind() 绑定变量名（如 :name），getLastSql() 不会展开，必须用 getRealSql()（TP6.0+）或自行拼接

驱动迁移不是改个配置就完事。最常被忽略的是 DSN 中 charset 缺失、连接复用逻辑干扰、以及预处理下 SQL 日志的误导性——这三个点卡住的人最多。