一文搞懂PHP PDO数据库连接实战-php教程-PHP中文网

连接失败时先检查pdo_mysql扩展、dsn中charset=utf8mb4及用户名密码是否正确传入构造函数；必须设pdo::attr_errmode=>pdo::errmode_exception以捕获异常；多库需独立实例，预处理是防注入底线。

一文搞懂php pdo数据库连接实战

连接失败时先看这三件事

连不上不是代码写错了，大概率是环境或配置卡在第一步。遇到 PDOException 报错，别急着改 SQL，先确认：是否启用了 pdo_mysql 扩展、DSN 里有没有漏写 charset=utf8mb4、用户名密码是不是传进了构造函数而不是拼进 DSN。

常见错误现象：

Class 'PDO' not found → PHP 编译时没启用 PDO 核心扩展
could not find driver → pdo_mysql 没开启（php -m | grep pdo 看不到它）
SQLSTATE[HY000] [1045] Access denied → 用户名密码错，或 MySQL 用户没授权该 host

DSN 必须严格按格式写：mysql:host=localhost;dbname=testdb;charset=utf8mb4。不要加 port=3306，除非你真改了端口；charset=utf8mb4 必须写在 DSN 里，靠 SET NAMES 或建表时设编码救不了连接层的乱码。

为什么必须设 `PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION`

默认的 SILENT 模式会让错误静默失败——query() 返回 false，prepare() 返回 null，但你不 catch 就根本不知道哪条语句挂了。线上出问题时只能靠猜。

设成异常模式后，所有数据库操作失败都会抛 PDOException，你可以统一用 try/catch 捕获，记录日志、返回友好提示，而不是让脚本崩在半路。

顺手加上这两项能省不少事：

PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC：后续 fetch() 默认返回关联数组，不用每次写 fetch(PDO::FETCH_ASSOC)
PDO::ATTR_EMULATE_PREPARES => false：关掉模拟预处理，让 MySQL 服务端真正校验 SQL 语法和类型，避免 INT 字段被当成字符串传入

多数据库连接不能共用一个 `$pdo` 实例

想同时查 MySQL 和 PostgreSQL？别想着“切换 database”——PDO 的单个连接对象只属于一个数据库驱动和一个服务器实例。跨库操作分两种情况：

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

同一 MySQL 服务器下的不同库：用 db1.users 和 db2.orders 这种写法，一个 $pdo 就够
MySQL + PostgreSQL 或不同服务器：必须创建两个独立实例，比如 $pdo_mysql 和 $pdo_pgsql，各自管理连接、事务、错误处理

推荐用配置数组 + 工厂函数封装，避免硬编码：

$configs = [
    'mysql' => ['dsn' => 'mysql:host=localhost;dbname=shop;charset=utf8mb4', 'user' => 'root', 'pass' => ''],
    'pgsql' => ['dsn' => 'pgsql:host=localhost;dbname=report', 'user' => 'rep_user', 'pass' => 'xxx']
];
<p>function getPdoConnection(string $key): PDO {
global $configs;
if (!isset($configs[$key])) {
throw new InvalidArgumentException("Unknown DB config: $key");
}
$cfg = $configs[$key];
$pdo = new PDO($cfg['dsn'], $cfg['user'], $cfg['pass']);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
return $pdo;
}</p>

调用：$db1 = getPdoConnection('mysql');、$db2 = getPdoConnection('pgsql');