答案是phpstorm报“ext-pdo_mysql missing”源于其配置的php cli环境未启用pdo_mysql扩展,需通过php --ini定位对应php.ini、按系统安装启用(如ubuntu用sudo apt install php-mysql),再用php -m验证并刷新phpstorm解释器配置。

PhpStorm报错“ext-pdo_mysql missing”不是IDE的问题
PhpStorm 本身不安装、不启用任何 PHP 扩展,它只读取你指定的 PHP 解释器(php 可执行文件)所加载的扩展列表。当你在 PhpStorm 中运行 composer install 或调试脚本报 ext-pdo_mysql 缺失,说明的是:你配置给 PhpStorm 的那个 PHP CLI 环境没加载 pdo_mysql,和 Web 服务器是否正常完全无关。
常见错误现象:
- 浏览器打开
phpinfo()显示PDO drivers包含mysql,但 PhpStorm 里php -m不输出pdo_mysql - PhpStorm 设置里选了
/usr/bin/php,但实际运行php --ini发现它用的是/etc/php/8.2/cli/php.ini,而你改的是 Apache 的php.ini - 装了多个 PHP 版本(比如 Homebrew 装了
php@8.2,系统自带php),PhpStorm 指向了没装扩展的那个
确认 PhpStorm 正在用哪个 PHP CLI 和 php.ini
别靠猜测或 IDE 界面里的路径显示——直接问 PHP:
- 在终端执行:
php --ini→ 记下 “Loaded Configuration File” 后面的完整路径 - 再执行:
php -m | grep pdo→ 看输出里有没有pdo_mysql(注意:只有pdo不够,必须有具体驱动) - 进 PhpStorm → Settings → PHP → CLI Interpreter → 点右侧三个点 → “Show all paths” → 对照它指向的
php是否和你刚才执行命令的是同一个
如果 PhpStorm 用的不是你预期的 PHP,就在这里重新选择正确的可执行文件(例如 /opt/homebrew/bin/php 或 /usr/bin/php8.2)。
按系统安装并启用 pdo_mysql(CLI 环境专用)
重点:所有操作针对的是 php --ini 显示的那个 php.ini 所属的 PHP 版本,不是 Web 版本。
-
Ubuntu/Debian:运行
sudo apt install php-mysql(自动启用,无需改php.ini);然后php -m | grep pdo_mysql验证 -
CentOS/RHEL:运行
sudo dnf install php-pdo php-mysqlnd;php -m应同时看到pdo和pdo_mysql -
macOS + Homebrew:先确认版本:
brew list | grep php;再重装对应版本,如brew reinstall php@8.2(Homebrew 默认启用pdo_mysql) -
Windows(XAMPP/WAMP):打开
php --ini显示的php.ini,找到;extension=pdo_mysql或;extension=php_pdo_mysql.dll,取消注释;注意检查extension_dir是否指向正确的ext/目录,并确认该目录下存在对应文件名(如php_pdo_mysql_82.dll)
验证成功后再回 PhpStorm 刷新
改完配置必须重启相关服务,但 PhpStorm 不需要重启 Apache/Nginx —— 它只依赖 CLI:
- Linux/macOS:不用重启服务,只要确保
php -m | grep pdo_mysql有输出即可 - Windows:改完
php.ini后,建议重启命令行终端(CMD/PowerShell),再测试php -m - 回到 PhpStorm → Settings → PHP → CLI Interpreter → 点右侧刷新按钮(?)→ 查看 “Loaded extensions” 列表是否出现
pdo_mysql - 最后跑一次
composer install或新建一个test.php写new PDO('mysql:host=localhost', '', '');测试是否抛异常
最容易被忽略的点是:你以为自己在改 CLI 的 php.ini,结果编辑的是 Apache 的;或者以为装了 php-mysql 就万事大吉,却忘了它只作用于当前 PHP 版本,而 PhpStorm 指向了另一个未启用扩展的版本。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











