PhpStorm不安装PHP扩展，仅读取已配置的PHP解释器及其启用的扩展；需验证php -m输出、确认php.ini中extension未被注释、在IDE中指定正确解释器路径并刷新扩展列表。
PhpStorm 本身不“安装”或“加载” PHP 扩展（如 pdo_mysql、redis、gd），它只是读取你本地已配置好的 PHP 解释器及其启用的扩展。所谓“添加扩展库”，实际是配置 PhpStorm 使用一个**已启用目标扩展的 PHP 可执行文件（php.exe 或 php）**。
确认扩展是否真在 PHP 中启用
这是最容易被跳过的一步。很多人以为在 PhpStorm 里点几下就能“加上”扩展，结果运行时报 Class not found 或 Call to undefined function —— 其实是 PHP CLI 根本没加载那个扩展。
- 打开终端，运行
php -m，检查输出中是否包含你要的扩展名（如redis、opcache） - 运行
php --ini查看加载的php.ini路径，然后打开该文件，确认对应扩展行未被注释，例如：extension=redis（Linux/macOS）或extension=php_redis.dll（Windows） - 如果改了
php.ini，记得重启终端或重新加载环境（尤其 Windows 下可能需重启 PhpStorm）
在 PhpStorm 中指定正确的 PHP 解释器路径
PhpStorm 需要知道用哪个 php 可执行文件 —— 它必须指向一个已启用所需扩展的 PHP 安装（不是 XAMPP 自带的 GUI 版 php.exe，也不是 Docker 容器内未暴露的 php）。
- 进入 File → Settings → Languages & Frameworks → PHP（macOS 是 PhpStorm → Preferences）
- 点击
Interpreter右侧的...按钮 - 点击
+→Add Interpreter → System Interpreter - 浏览并选择你已验证过扩展可用的 PHP 可执行文件，例如：
/usr/bin/php（Ubuntu）/opt/homebrew/bin/php（macOS Homebrew）C:\xampp\php\php.exe（Windows XAMPP，前提是该 php.exe 对应的 php.ini 已启用扩展） - 选中后，PhpStorm 会自动解析版本和已启用扩展列表；若列表为空或缺失关键扩展，请返回上一步排查
验证扩展是否被 PhpStorm 正确识别
即使解释器路径正确，PhpStorm 有时会缓存旧的扩展信息，导致代码补全或类型推断失效。
PHP是一种功能强大的网络程序设计语言，而且易学易用，移植性和可扩展性也都非常优秀，本书将为读者详细介绍PHP编程。 全书分为预备篇、开始篇和加速篇三大部分，共9章。预备篇主要介绍一些学习PHP语言的预备知识以及PHP运行平台的架设；开始篇则较为详细地向读者介绍PKP语言的基本语法和常用函数，以及用PHP如何对MySQL数据库进行操作；加速篇则通过对典型实例的介绍来使读者全面掌握PHP。 本书
立即学习“PHP免费学习笔记（深入）”；
- 在设置页点击解释器下方的
Show all PHP Extensions链接，查看完整列表 - 搜索你要用的扩展名（如
mysqli），确认状态为enabled - 如果刚启用扩展但这里没显示，尝试点击右上角的
Reload图标（循环箭头）强制刷新 - 写一行测试代码验证补全：
new Redis(); // 如果 redis 扩展已识别，这里应有类提示
常见踩坑点：Docker、WSL、多版本 PHP
这些环境让“PHP 解释器路径”变得不直观，也是新手最常卡住的地方。
-
Docker：不能直接选宿主机上的
php；需配置Remote Interpreter → Docker，并确保容器内php -m输出含目标扩展 -
WSL2：不要选 Windows 下的
php.exe；应选 WSL 内路径如/usr/bin/php，且需在 WSL 终端中验证php -m | grep gd -
多版本管理（如 phpbrew、asdf）：确保终端当前 shell 的
php命令指向你要的版本（which php），再把这个路径填进 PhpStorm - 修改
php.ini后只重启 Apache？没用。PhpStorm 用的是 CLI 模式，必须保证php -v和php -m生效
真正起作用的永远是你系统里那个 php 可执行文件和它背后的 php.ini；PhpStorm 只是它的观察者和调用者。别在 IDE 设置里找“安装扩展”的按钮——那不存在。
