PHP 8.0中PDO连接数据库失败，如何确认pdo_mysql扩展已正确加载？

本文共计829个文字，预计阅读时间需要4分钟。

这是最典型的表现：

常见原因不是“没装”，而是“没对上”：

• extension_dir 路径写错，PHP 去错了目录找 php_pdo_mysql.dll（Windows）或 pdo_mysql.so（Linux）
• 扩展名写错，比如写成 extension=php_pdo_mysql 漏了 .dll 或 .so 后缀
• 扩展加载顺序错误：在 Windows 上，extension=pdo 必须出现在 extension=php_pdo_mysql 之前；在 Linux 上，如果 PDO 是共享模块，pdo 也得先于具体驱动加载
• PHP 是 NTS 版本，却用了 TS 的 DLL（或反之），尤其在 PHPStudy、XAMPP 等集成环境中极易踩坑

确认 php -m 输出里有没有 pdo_mysql

命令行比 Web 环境更干净，能快速排除 Apache/Nginx 配置干扰。在终端执行：

php -m | grep -i pdo

你期望看到类似：

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

pdo pdo_mysql pdo_sqlite

如果只有 pdo 没有 pdo_mysql，问题就锁定在扩展配置环节。此时检查：

• php --ini 查出实际生效的 php.ini 路径，别改错文件
• 打开该 php.ini，确认 extension_dir 指向的是真实存在 php_pdo_mysql.dll 的目录（Windows）或 pdo_mysql.so 的路径（Linux）
• 确认该行未被注释且拼写正确：extension=php_pdo_mysql.dll（Windows）或 extension=pdo_mysql.so（Linux）
• 重启 PHP-FPM 或 Web 服务（sudo systemctl restart php8.0-fpm 或 sudo service apache2 restart）

连接时报 PDOException: could not find driver

这个错误不是凭据错，是驱动根本不可用。它发生在 new PDO('mysql:host=...') 时，PDO 解析 DSN 发现没有注册 mysql 驱动。

注意两个关键点：

• 即使 phpinfo() 显示 PDO 已启用，也不代表所有驱动都齐了——PDO 是容器，pdo_mysql 是插件，插件没装/没启，容器照样报错
• DSN 字符串里的 mysql: 前缀必须和已加载驱动名严格匹配。比如你只启了 pdo_pgsql，却写 mysql:host=...，一样报这个错
• 某些旧版 PHP（如 7.x）默认不带 pdo_mysql，需手动安装；PHP 8.0+ 多数发行版仍需显式启用

Windows 下 dll 文件缺失或 ABI 不兼容

PHP 8.0 分 TS（Thread Safe）和 NTS（Non-Thread Safe）两个 ABI，驱动 DLL 必须完全匹配。例如：

• Apache + mod_php → 必须用 php80ts_*.dll
• nginx + PHP-FPM → 一般用 php80nts_*.dll
• 文件名含 php81 却跑在 PHP 8.0 上 → 加载失败静默忽略（不会报错，但也不工作）

验证方式：用 php -v 看输出末尾是否带 (NTS) 或 (TS)；再核对 DLL 文件名中的版本号与 TS/NTS 标识是否一致。达梦、SQL Server 等第三方驱动同样遵循此规则，不能混用。