XAMPP开启pdo_mysql方法及数据库连接教程

本文详细解析了XAMPP环境下PDO MySQL扩展看似“默认启用”实则无法使用的常见陷阱，直击核心问题：php.ini中extension=pdo_mysql被注释、extension_dir路径配置错误、Apache未真正重启，以及CLI与Web环境使用不同php.ini导致的配置割裂；通过phpinfo()验证加载状态、精准修改配置文件、命令行语法检测和日志排查等实操步骤，手把手教你彻底激活pdo_mysql，并确保数据库连接稳定可靠——告别玄学报错，让每一次PDO连接都经得起检验。

pdo_mysql 扩展默认已启用，但实际不可用，大概率是 php.ini 里没真正生效，或 Apache 没重启。

确认 pdo_mysql 是否真的加载了

别信“默认开启”这种说法。很多 XAMPP 版本（尤其是新版）的 php.ini 里，extension=pdo_mysql 这行是被注释掉的，或者压根没写对名字。

• 先建一个 info.php 文件，内容只有 ，放在 C:\xampp\htdocs\ 下，浏览器访问 http://localhost/info.php
• 搜索 pdo_mysql —— 如果页面里完全没出现这一项，说明扩展根本没加载
• 再搜 Loaded Configuration File，确认你编辑的 php.ini 确实是这个路径下的文件（常见错误：改了错的 php.ini，比如 php.ini-development 或 php.ini-production）

修改 php.ini 启用 pdo_mysql 的正确写法

Windows 下 XAMPP 的扩展名是 .dll，不是 .so；且 PHP 7.4+ 已弃用 php_pdo.dll 这类旧命名方式，直接用短名即可。

• 打开 C:\xampp\php\php.ini（用记事本或 VS Code，别用 Word）
• 搜索 extension_dir，确认值类似 extension_dir="C:/xampp/php/ext" —— 路径斜杠用正斜杠或双反斜杠，单反斜杠会出错
• 搜索 pdo_mysql，找到这行：;extension=pdo_mysql，删掉开头的分号
• 如果搜不到，就在 [Dynamic Extensions] 区域末尾手动加一行：extension=pdo_mysql
• 顺手检查 extension=mysqli 也已启用（PDO_MySQL 依赖它底层通信）

Apache 不重启 = 白改

改完 php.ini 后，XAMPP 控制面板里点 Restart 不一定真重启了 Apache —— 有时只是“尝试重启”，状态栏没变红也不代表成功。

• 看控制面板 Apache 行右侧是否显示 Running，且图标是绿色
• 更可靠的方式：打开命令行，进 C:\xampp\apache\bin，执行 httpd -t —— 如果输出 Syntax OK 才说明配置无语法错误
• 如果重启失败，去 C:\xampp\apache\logs\error.log 查最后一行错误，常见如 PHP Startup: Unable to load dynamic library 'pdo_mysql'，说明 DLL 文件缺失或路径不对
• 注意：某些 XAMPP 版本（如 8.2+）默认用 PHP 8.x，而 php_pdo_mysql.dll 这类旧名已失效，必须用 extension=pdo_mysql

连接测试时仍报错 Class 'PDO' not found？

这不是扩展问题，而是脚本运行在 CLI 模式下用了另一个 php.ini，和 Apache 加载的不是同一个。

• 在命令行执行 php --ini，看它用的是哪个 php.ini；通常 CLI 默认用 C:\xampp\php\php.ini，但有时会 fallback 到 php-cli.ini
• 如果你用命令行跑测试脚本（比如 php test.php），务必确认 CLI 模式的 php.ini 也启用了 pdo_mysql
• 最省事的办法：所有测试都走浏览器（http://localhost/test.php），确保和 Web 环境一致

真正卡住的地方往往不是“怎么开”，而是改了哪个 php.ini、Apache 有没有彻底重启、CLI 和 Web 用的配置是不是两套。别跳过 phpinfo() 那一步，眼见为实。

文中关于XAMPP的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《XAMPP开启pdo_mysql方法及数据库连接教程》文章吧，也可关注golang学习网公众号了解相关技术文章。