PHP 8.5 迁移 PDO 驱动常量时要改哪些代码

PHP 8.5 迁移 PDO 时，不是把所有 PDO:: 都替换掉，而是只处理驱动专属常量。旧常量目前仍是弃用别名，推荐写到 Pdo\Mysql、Pdo\Sqlite 等驱动子类中。MySQL 最常见的改动是把 PDO::MYSQL_ATTR_INIT_COMMAND 改为 Pdo\Mysql::ATTR_INIT_COMMAND。

官方文档：https://www.php.net/migration85

先划清 PHP 8.5 的 PDO 常量迁移范围

PDO::ATTR_ERRMODE、PDO::ATTR_DEFAULT_FETCH_MODE、PDO::ATTR_TIMEOUT 和 PDO::ATTR_EMULATE_PREPARES 属于 PDO 通用接口，继续使用即可。带有 MYSQL、SQLITE、PGSQL 等驱动前缀的名字，才是本次迁移重点。

这次调整的价值是让配置归属和实际驱动一致。它不会自动安装 pdo_mysql、修复 DSN，也不会改变数据库权限。

把 MySQL 配置数组改成驱动子类常量

连接选项只改数组键，DSN、异常模式和业务查询可以保持原样：

 PDO::ERRMODE_EXCEPTION,
    Pdo\\Mysql::ATTR_INIT_COMMAND => 'SET NAMES utf8mb4',
    Pdo\\Mysql::ATTR_SSL_CA => '/etc/ssl/certs/ca.pem',
];

try {
    // 注释：mysql DSN 决定使用 PDO MySQL 驱动。
    $pdo = new PDO('mysql:host=127.0.0.1;dbname=app;charset=utf8mb4', $user, $password, $options);
} catch (PDOException $exception) {
    // 注释：向上层传递异常，不把密码和完整连接信息返回给用户。
    throw new RuntimeException('数据库连接失败', 0, $exception);
}

DIRECT_QUERY 不要机械改成不存在的 Pdo\Mysql::ATTR_DIRECT_QUERY；官方文档将它视作 PDO 模拟预处理属性的别名。SQLite 的 PDO::SQLITE_DETERMINISTIC 对应 Pdo\Sqlite::DETERMINISTIC，PgSQL 的专属属性则对应 Pdo\Pgsql::ATTR_*。

用驱动检测和日志完成迁移回归

多驱动项目按 DSN 拆分配置，并用 $pdo->getAttribute(PDO::ATTR_DRIVER_NAME) 确认实际驱动；PDO::ATTR_EMULATE_PREPARES 仍是通用属性。

• 确认目标环境加载 pdo 和实际驱动扩展。
• 搜索 PDO::MYSQL_、PDO::SQLITE_、PDO::PGSQL_ 残留并查看弃用日志。
• 回归连接、预处理、事务、SSL 和大结果集读取，再进行灰度升级。

相关问题

PHP 8.5 还能使用 PDO::MYSQL_ATTR_* 吗？

当前仍可用，但会进入弃用路径。维护中的代码应迁移到对应的 Pdo\Mysql::ATTR_*。

PDO::ATTR_ERRMODE 要改成 Pdo\Mysql::ATTR_ERRMODE 吗？

不用。它是通用 PDO 属性，继续使用 PDO::ATTR_ERRMODE。

改完常量仍然连接失败怎么办？

先查 pdo_mysql、DSN、证书路径和账号权限；常量迁移本身不会修复这些运行环境问题。