PhpStorm 本身不带 PHP 解释器，必须先在系统中独立安装 PHP 并手动指向其可执行文件（如 php.exe 或 /opt/homebrew/bin/php），否则会报“Cannot resolve PHP interpreter”；它仅作为 IDE 调用外部 PHP 运行时，不提供运行环境，且 CLI 与 Web SAPI 需严格区分，路径映射错误或误选 php-cgi 会导致运行、调试失败。
PhpStorm 本身不带 PHP 解释器，必须先在系统中独立安装 PHP，再让 PhpStorm 指向它——跳过这步直接配解释器会报 Cannot resolve PHP interpreter 或提示“no PHP version detected”。
为什么不能只靠 PhpStorm 自带 PHP？
JetBrains 官方明确说明：PhpStorm 是 IDE，不是运行时环境。它依赖外部 php.exe（Windows）或 php（macOS/Linux）二进制文件来执行代码、解析语法、启用 Xdebug 调试。没这个文件，phpinfo() 运行不了，composer install 会失败，甚至基础的函数跳转都失效。
- 常见错误现象：
PHP version is not configured、右下角状态栏显示“PHP: unknown”、点击“Run”按钮灰掉 - Windows 用户常误以为装了 WampServer/XAMPP 就等于“已安装 PHP”，其实只是集成包里包含 PHP，仍需手动指定
php.exe路径 - macOS 用户用 Homebrew 安装后，
which php返回的是/opt/homebrew/bin/php，但 PhpStorm 有时会默认读取系统自带的/usr/bin/php（版本老旧且无扩展），必须手动切换
如何验证本地 PHP 是否真正可用？
别信“我点开 phpstudy 就能跑网页”——那只是 Web 服务在工作，不代表 CLI（命令行）环境就绪。打开终端，逐条执行：
-
php -v：必须输出类似PHP 8.2.12 (cli)，且无Failed loading报错 -
php -m | grep xdebug（如需调试）：确认 Xdebug 已加载；若无输出，说明php.ini里没启用，或扩展路径不对 -
php -i | grep "Loaded Configuration File"：记下这个路径，后续 PhpStorm 配置 Xdebug 时要用到 - 把
php.exe所在目录加进系统PATH（Windows）或~/.zshrc（macOS），否则 PhpStorm 在某些场景下可能找不到它
PhpStorm 中配置解释器的关键操作
路径必须精确到可执行文件，不是文件夹；且 PhpStorm 会缓存旧配置，改完要重启项目或清除索引。
立即学习“PHP免费学习笔记（深入）”；
- 入口：菜单
File → Settings → Languages & Frameworks → PHP（Windows/Linux）或PhpStorm → Preferences → Languages & Frameworks → PHP（macOS） - 点击
Interpreter右侧齿轮 →Add Interpreter → Add Local...→ 点击三点图标浏览，**选中php.exe（Windows）或php（macOS/Linux）**，不是php-cgi.exe，也不是php.ini - 配置成功后，下方会显示 PHP 版本、已启用的扩展（如
mbstring、curl），若显示“N/A”或空列表，说明路径错或权限不足 - 如果使用 phpStudy/XAMPP/WampServer：Windows 典型路径是
D:\phpstudy_pro\Extensions\php\php8.2nts\php.exe或C:\xampp\php\php.exe；macOS 上 MAMP 是/Applications/MAMP/bin/php/php8.2.12/bin/php
容易被忽略的路径映射与服务器配置
光有解释器只能跑 CLI 脚本，但开发 Web 项目时，http://localhost/test.php 要能访问，就得告诉 PhpStorm：“这个项目文件，在浏览器里对应哪个 URL 路径”。
- 进入
Settings → PHP → Servers，点+添加服务器 -
Host填localhost，Port填你 Web 服务器实际监听的端口（Apache 默认 80，Nginx 默认 80，若被占用则填 8080） - 务必勾选
Use path mappings，然后将项目根目录（如D:\phpstudy_pro\WWW）映射到/—— 这一步漏掉，Xdebug 断点永远不触发，浏览器预览也 404 - 右键 PHP 文件 →
Open in Browser，URL 应该是http://localhost/test.php，而不是file:///D:/xxx/test.php
最常出问题的地方不是“找不到 php.exe”，而是路径映射没设对，或者用了 php-cgi.exe 当解释器。CLI 和 Web SAPI 是两套机制，混用必然失败。
