PHP 默认不启用 PDO 扩展,需手动安装、启用并验证:用 php -m | grep pdo 检查是否加载,或 phpinfo() 查看 PDO support 是否 enabled 及 drivers 是否包含所需数据库类型;Linux 下需同时安装 php-pdo 和 php-mysqlnd 并重启 Web 服务;Windows 下需在 php.ini 中取消 extension=php_pdo.dll 等三行注释并确认 .dll 文件名正确;最后用最小测试脚本验证连接。

PHP 默认不启用 PDO 扩展,必须手动确认安装、启用并验证——否则 new PDO() 会直接报错 Class 'PDO' not found 或 Call to undefined function pdo_connect()。
怎么看 PDO 扩展装没装、启没启
别猜,直接用 PHP 自带命令查:
php -m | grep pdo
如果输出里有 pdo 和 pdo_mysql(或其他驱动如 pdo_pgsql),说明扩展已安装且启用;只看到 pdo 没有具体驱动,说明 PDO 核心有了,但连 MySQL 都连不了;啥都没输出,就是完全没装或被注释掉了。
也可以建个 info.php 文件写
PDO,看 “PDO support” 是 enabled,再往下确认 “PDO drivers” 是否包含你需要的数据库类型。
立即学习“PHP免费学习笔记(深入)”;
Linux(Ubuntu/Debian)下装 PDO 和 MySQL 驱动
常见错误是只装了 php-pdo,却漏掉对应数据库驱动。MySQL 场景下必须同时装两个包:
-
php-pdo:提供 PDO 基础类和接口 -
php-mysql或php-mysqlnd:提供pdo_mysql驱动(推荐php-mysqlnd,更现代、支持更多特性)
执行命令:
sudo apt update
sudo apt install php-pdo php-mysqlnd
装完别忘了重启 Web 服务:sudo systemctl restart apache2(Apache)或 sudo systemctl restart php*-fpm(如 php8.2-fpm)。
Windows(WAMP/XAMPP)手动启用 PDO
不是装新东西,而是改配置。找到你的 php.ini 文件(用 php --ini 查路径),编辑它:
- 取消注释这三行(删掉前面的分号
;):;extension=php_pdo.dll;extension=php_pdo_mysql.dll;extension=php_mysqli.dll(虽不是 PDO,但常一起用) - 确保
extension_dir指向正确的扩展目录,比如extension_dir = "ext"(相对路径)或绝对路径
改完保存,重启 Apache 或 Nginx。注意:不同 PHP 版本的 .dll 名可能带版本号(如 php_pdo_mysql_82.dll),若启用失败,去 ext/ 目录下确认真实文件名再填。
验证是否真能用了
写个最小测试脚本,别用框架或 ORM 包裹着测:
try {
$pdo = new PDO('mysql:host=localhost;dbname=test;charset=utf8mb4', 'root', '');
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
echo "PDO 连接成功 ✅";
} catch (PDOException $e) {
echo "连接失败 ❌: " . $e->getMessage();
}
关键点:
- DSN 中的
charset=utf8mb4强烈建议加上,避免中文乱码 - 如果报
Driver not found,说明pdo_mysql没启用;报Connection refused,则是数据库服务没开,跟 PDO 无关 - Windows 下若提示
Unable to load dynamic library,大概率是php.ini里写的.dll名字不对,或依赖的libmysql.dll缺失(XAMPP 一般自带,WAMP 可能需要手动放)
PDO 扩展本身很简单,难的是环境链路太长:PHP 编译选项、包管理器行为、ini 加载顺序、Web 服务进程是否重载配置……任何一个环节断了,new PDO() 就只是个报错。动手前先 php -m,动手后必 systemctl restart,别省这两步。











