phpenv中需手动启用pdo及pdo_mysql扩展:确认php版本与对应php.ini路径,检查extension_dir下存在php_pdo_mysql.dll,取消extension=php_pdo.dll和extension=php_pdo_mysql.dll前的分号,重启php服务后通过phpinfo()验证;连接时dsn必须显式指定charset=utf8mb4。

phpEnv 是 Windows 下轻量级 PHP 开发环境,它默认不启用 PDO_MYSQL 扩展,直接写 new PDO() 会报 “Class 'PDO' not found” 或 “could not find driver” 错误。必须手动修改配置并重启服务。
确认 phpEnv 当前使用的 PHP 版本和 php.ini 路径
phpEnv 界面右下角显示当前激活的 PHP 版本(如 PHP 8.2),点击“PHP 配置”按钮可打开对应版本的 php.ini 文件。不要编辑其他版本或系统全局的配置 —— phpEnv 每个 PHP 版本都独立管理自己的 php.ini。
常见错误:在错误的 php.ini 里取消注释扩展,但 phpEnv 实际加载的是另一个路径下的文件。
- 打开 phpEnv 主界面 → 右键当前 PHP 版本 → “打开 php.ini”
- 搜索
extension_dir,确认值类似"D:/phpenv/php/php-8.2-x64/ext",该路径下应存在php_pdo_mysql.dll - 若不存在该文件,说明当前 PHP 版本未自带 MySQL 驱动,需更换 phpEnv 提供的带完整扩展的 PHP 包(如选 “PHP with all extensions”)
启用 PDO 和 pdo_mysql 扩展
在正确打开的 php.ini 中,找到以下两行,去掉前面的分号(;)使其生效:
extension=php_pdo.dll extension=php_pdo_mysql.dll
注意:不是 extension=pdo_mysql,也不是 extension=pdo —— phpEnv 使用的是 Windows DLL 命名规范,扩展名必须带 .dll 后缀。
部分新版 phpEnv(基于 PHP 8.1+)可能已改用统一命名:extension=pdo 和 extension=pdo_mysql,此时需按实际 ext/ 目录下的文件名匹配(可用资源管理器确认)。
- 保存
php.ini后,必须点击 phpEnv 界面的 “Restart PHP” 按钮,不能只重启 Apache/Nginx - 重启后访问
phpinfo()页面,搜索pdo和pdo_mysql,看到两处 “enabled” 才算成功 - 若仍报错 “driver not found”,检查
php_pdo_mysql.dll是否依赖 Visual C++ 运行库(phpEnv 通常自带,但精简版可能缺失)
连接时 DSN 中 charset 参数要显式指定
即使扩展已启用,new PDO("mysql:host=localhost;dbname=test", $u, $p) 仍可能因字符集问题导致中文乱码或插入失败 —— phpEnv 默认不设 charset,MySQL 8.0+ 默认用 utf8mb4,而旧版驱动可能 fallback 到 latin1。
必须在 DSN 中明确声明:
$dsn = "mysql:host=localhost;dbname=test;charset=utf8mb4";
不要写 utf8(MySQL 中它仅是 utf8mb3 的别名,不支持 emoji);也不要漏掉 charset=,否则 PDO 不会自动发送 SET NAMES。
- 若用 MySQL 8.0+ 且 PHP default_authentication_plugin=mysql_native_password,否则连不上(错误提示含
caching_sha2_password) - 宝塔或 Linux 环境不用操心这个,但 phpEnv 是 Windows + MySQL 本地组合,此问题高频出现
最易被忽略的一点:phpEnv 的 Apache/Nginx 服务进程和命令行 php -v 可能加载不同配置。测试连接务必用 Web 方式(如放 test.php 在网站根目录访问),而非 cmd 执行 —— 否则你调通了 CLI 却连不上网页。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











