phpEnv中PDO默认已编译但pdo_mysql常被禁用,需手动启用php_pdo.dll和php_pdo_mysql.dll扩展、在DSN中显式指定charset=utf8mb4、并禁用PDO::ATTR_EMULATE_PREPARES以确保类型安全。

phpEnv 是 Windows 下的 PHP 集成环境(类似 XAMPP、WAMP),默认通常已编译 PDO,但 pdo_mysql 等具体驱动常被禁用——所以“PDO 类找不到”或“连接 MySQL 失败”八成不是没装,而是没启用驱动。
确认 phpEnv 中 PDO 和 pdo_mysql 是否已加载
打开 phpEnv 自带的 PHP Info 页面(一般在控制面板点 “PHP Info” 或访问 http://localhost/phpinfo.php),搜索以下两项:
-
PDO—— 看是否显示 “enabled”,且下方有 “PDO drivers” 列出mysql、sqlite等 -
pdo_mysql—— 单独搜这一行,必须出现且状态为 enabled
如果只看到 PDO enabled 但没 pdo_mysql,说明驱动没开;如果连 PDO 都没出现,那可能是 phpEnv 版本太老(低于 PHP 5.1)或配置被手动破坏。
在 phpEnv 中启用 pdo_mysql 扩展
phpEnv 的 php.ini 通常位于:phpEnv\php\php.ini(路径以你安装目录为准,不是系统级的 C:\Windows\php.ini)。
立即学习“PHP免费学习笔记(深入)”;
用记事本或 VS Code 打开它,找到这两行(大概在 “Dynamic Extensions” 区域附近):
;extension=php_pdo.dll ;extension=php_pdo_mysql.dll
把分号去掉,改成:
extension=php_pdo.dll extension=php_pdo_mysql.dll
注意:不要写成 extension=pdo_mysql.so(那是 Linux 路径);也不要加引号或空格;保存后必须重启 phpEnv 的 Apache/Nginx 服务(不是只刷新页面)。
DSN 字符集必须显式声明 utf8mb4
phpEnv 常搭配旧版 MySQL(如 5.6),但默认 DSN 不带 charset 会导致中文乱码、emoji 插入失败,且 SET NAMES 在连接复用时不可靠。
正确写法是把 charset=utf8mb4 直接塞进 DSN 字符串里:
$dsn = "mysql:host=127.0.0.1;dbname=test;charset=utf8mb4";
错误写法(无效):
-
"mysql:host=127.0.0.1;dbname=test"+ 后续执行$pdo->exec("SET NAMES utf8mb4") -
"mysql:host=127.0.0.1;dbname=test;charset=utf8"(utf8是 MySQL 的伪编码,不支持 4 字节字符)
如果你用的是 phpEnv 内置的 MySQL,且版本 ≤ 5.5.3,得先升级 MySQL 或改用 utf8 并接受 emoji 不支持——但别妥协,phpEnv 新版基本都配了 5.7+。
连接时必须禁用预处理模拟
phpEnv 默认可能开启 PDO::ATTR_EMULATE_PREPARES,这会让 PHP 自己解析 SQL 占位符,绕过 MySQL 服务端预处理,导致 INT 类型参数被当成字符串传入,引发隐式类型转换或 WHERE 条件失效。
务必在构造 PDO 实例时传入选项数组:
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_EMULATE_PREPARES => false,
];漏掉这一项,prepare("SELECT * FROM users WHERE id = ?")->execute([123]) 可能查不到数据,因为 MySQL 收到的是 '123'(字符串)而非 123(整数)。
这个坑在 phpEnv 上特别隐蔽:本地开发一切正常,一上生产(MySQL 严格模式开启)就报错或逻辑异常。



















