根本原因是GUI启动不继承shell环境变量，必须用which php或where php获取绝对路径后，在Settings→PHP→Interpreter中手动指定php.exe或php文件；右下角须显示PHP版本，否则检查路径、权限、运行时依赖及是否误选php-cgi.exe。
PhpStorm提示“Cannot detect PHP version”或“Command 'php' not found”
根本不是PHP没装好，而是GUI启动的PhpStorm压根不读你终端里的PATH——macOS从Dock点开、Windows双击快捷方式时，进程根本不加载~/.zshrc或注册表PATH。你在终端敲php -v成功，IDE里照样报错。
必须手动指定绝对路径：
- 终端执行
which php（macOS/Linux）或where php（Windows），拿到类似/opt/homebrew/bin/php或C:\php\php.exe的结果 - PhpStorm → Settings → Languages & Frameworks → PHP → Interpreter → 点齿轮 → Add → Local → 浏览并精准选中该文件
- 选完立刻看右下角是否显示
PHP 8.2.12 (cli)；没出现就说明路径错、文件无执行权限（Linux/macOS需chmod +x）、或Windows缺msvcr120.dll等运行时库
配置完解释器，右下角仍不显示PHP版本
常见原因不是路径填错了，而是你选中的是文件夹、软链接未解析、或指向了php-cgi.exe（Windows）这类非CLI二进制。
验证和修复要点：
立即学习“PHP免费学习笔记（深入）”；
-
php-cgi.exe不能用于PhpStorm解释器，必须用php.exe - macOS用户若用Homebrew安装PHP，
which php可能返回/opt/homebrew/bin/php，但实际是软链接；用ls -l确认它最终指向真实可执行文件 - Linux/macOS下检查权限：
ls -l $(which php)，确保有x位；没有就chmod +x /path/to/php - Windows上若报“找不到MSVCR120.dll”，去微软官网下载VC++2013 Redistributable并安装
php --ini显示的Loaded Configuration File和phpinfo()不一致
因为Web服务器（Apache/Nginx）和CLI调用的是两套php.ini。你在浏览器里看到的phpinfo()来自Web SAPI，而PhpStorm默认走CLI，读的是/etc/php/8.2/cli/php.ini（Ubuntu）或C:\php\php.ini（Windows）。
Xdebug必须配在CLI对应的php.ini里：
- 在PhpStorm内置Terminal中运行
php --ini，盯住Loaded Configuration File那行输出 - 编辑该文件，加入Xdebug 3最小必要配置（注意不是旧版
xdebug.remote_enable）：zend_extension=xdebugxdebug.mode=debugxdebug.client_host=127.0.0.1 - 端口默认是
9003，别写成旧版9000；改完重启PhpStorm - 再跑
php -m | grep xdebug，有输出才说明扩展已加载；没输出就检查extension_dir下是否存在xdebug.so或php_xdebug.dll
断点打了，“Start Listening for PHP Debug Connections”也点了，但请求一发就过
几乎全是服务器路径映射没对齐。Xdebug回传的文件路径（如/var/www/myapp/index.php）和PhpStorm本地路径无法匹配，连接被直接丢弃。
关键操作只有三步：
- Settings → Languages & Frameworks → PHP → Servers → 点“+”添加：Host填
localhost（别填127.0.0.1，某些Xdebug版本对host解析敏感），Port填Web服务实际端口（如80或8080） - 务必勾选
Use path mappings，把项目根目录（如D:\phpstudy_pro\WWW）映射到/；如果URL是http://localhost/myapp/index.php，映射路径就得是/myapp，不是/也不是D:\phpstudy_pro\WWW\myapp - phpStudy用户最容易漏掉这点：默认WWW目录映射填
/只适用于根级访问；一旦项目放在子目录，映射必须同步调整，否则断点永不触发
