在phpEnv搭建的PHP开发环境中，运行依赖数据库操作的代码时，很容易出现PHP Fatal error: Class ‘PDO’ not found的错误，这是因为当前PHP环境没有开启PDO扩展导致的。PDO是PHP提供的数据访问抽象层，能够统一操作多种数据库，是很多PHP项目必备的扩展组件。
错误触发场景
通常出现这个错误的场景有以下几种：
- 首次使用phpEnv搭建环境后，直接运行包含数据库操作的代码
- 切换了phpEnv中的PHP版本，新版本默认未开启PDO扩展
- 手动修改过PHP配置文件，误删了PDO扩展的加载项
解决步骤
第一步：确认当前PHP版本
打开phpEnv主界面，在顶部可以看到当前正在使用的PHP版本，比如是PHP 7.4、PHP 8.1等，后续操作需要对应到该版本的配置。
第二步：打开PHP配置文件
在phpEnv界面中，点击对应PHP版本右侧的php.ini按钮，会直接打开该版本的PHP配置文件。如果没有找到对应按钮，也可以手动到phpEnv安装目录下的php/php版本号/目录中找到php.ini文件打开。
第三步：开启PDO扩展
在php.ini文件中搜索extension=pdo，找到相关的扩展配置项：
;extension=pdo_mysql ;extension=pdo_pgsql ;extension=pdo_sqlite
去掉这些行前面的分号注释，保存配置文件。如果是Windows环境的phpEnv，还需要确认extension_dir配置指向正确的扩展目录，通常是extension_dir = "ext"。
第四步：重启PHP服务
回到phpEnv主界面，点击重启按钮，等待PHP服务重启完成，让配置生效。
验证配置是否生效
可以创建一个测试文件，代码如下：
<?php
// 检查PDO类是否存在
if (class_exists('PDO')) {
echo 'PDO扩展已成功开启';
} else {
echo 'PDO扩展未开启';
}
?>
在浏览器中访问这个测试文件，如果输出PDO扩展已成功开启，说明问题已经解决。如果还是提示错误，可以检查php.ini中是否有其他配置冲突，或者查看PHP错误日志定位具体问题。
注意事项
如果项目使用的是MySQL数据库，除了开启PDO扩展，还需要确保pdo_mysql扩展已经开启，否则会出现无法连接MySQL的问题。如果切换了PHP版本，每个版本的php.ini都需要单独配置，配置不会自动同步到新版本。
phpEnvPDOPHP_Fatal_errorclass_not_found修改时间：2026-06-20 13:00:12