PhpStorm切换PHP版本需手动指定XAMPP的php.exe路径，而非依赖系统PATH；关键步骤包括：Settings→PHP→CLI Interpreter→Add→Local→浏览至C:\xampp\php\php.exe（Windows）或对应路径（macOS/Linux），并验证phpinfo()版本一致。
PHP CLI Interpreter 总是指向系统 PATH 里的 php.exe，而不是 XAMPP 的
这是最常被忽略的起点：PhpStorm 默认会从 PATH 环境变量找 php.exe，而你装了多个 PHP（比如 WSL、WSL2、Homebrew、Docker Desktop 自带的）时，php --version 和 PhpStorm 显示的版本很可能不一致。
必须手动指定 XAMPP 的可执行文件路径，否则 composer install、artisan 或单元测试都可能用错 PHP 版本或扩展。
- Windows：打开
File → Settings → PHP → CLI Interpreter，点击齿轮 →Add → Local，浏览到C:\xampp\php\php.exe - macOS/Linux：路径通常是
/Applications/XAMPP/xamppfiles/bin/php或/opt/lampp/bin/php，别选错 symlink 指向的源文件 - 添加后立刻点
Validate，确认输出的phpinfo()版本与xampp/htdocs/dashboard/phpinfo.php页面一致 - 如果提示 “Cannot resolve PHP executable”，检查该路径下是否存在
php.exe（Windows）或是否有执行权限（macOS/Linux）
调试端口 9003 不生效，Xdebug 连不上 PhpStorm
Xdebug 4（随 PHP 8.0+ 默认集成）已弃用 xdebug.remote_* 配置项，改用 xdebug.client_*。若仍沿用旧教程配置，Xdebug 就不会主动连接 PhpStorm。
关键不是“PhpStorm 是否监听”，而是“Xdebug 是否正确发起连接”。先验证本地配置是否生效：
立即学习“PHP免费学习笔记（深入）”；
- 编辑 XAMPP 的
php.ini（路径：C:\xampp\php\php.ini或/Applications/XAMPP/xamppfiles/etc/php.ini） - 确保启用的是
zend_extension=xdebug（不是extension=），且路径为绝对路径，例如：zend_extension="C:\xampp\php\ext\php_xdebug.dll" - 删除所有
xdebug.remote_*行，只保留以下几项（PHP 8.0+）：xdebug.mode=debugxdebug.client_host=localhostxdebug.client_port=9003xdebug.start_with_request=yes - 重启 Apache，访问
http://localhost/dashboard/phpinfo.php，搜索xdebug.mode，确认值为debug，且无红色报错
“In place” 部署类型下，浏览器预览 URL 总是 404 或跳转到 XAMPP 根目录
这不是 PhpStorm 的 bug，而是路径映射没对齐 Apache 的 DocumentRoot。XAMPP 默认把 htdocs 当作 Web 根目录，但 PhpStorm 的 “In place” 部署只是做文件同步，不改变 Apache 的请求路由逻辑。
你写的 index.php 必须放在 Apache 能服务到的位置，否则右键 → Open in Browser 就会 404。
- 在
File → Settings → Build, Execution, Deployment → Deployment中，添加新服务器，类型选In place - 在
Mappings标签页里：
–Local path填你 PhpStorm 项目的根目录（如D:\myproject）
–Web path on server填对应 URL 路径，例如/myproject（不是/htdocs/myproject） - 确保你的项目文件实际存放在
C:\xampp\htdocs\myproject\，否则 Apache 根本找不到它 - 如果想直接访问
http://localhost/myproject/index.php，就不要把项目放在htdocs外；如果放外面，就得配虚拟主机或改 Apache 的DocumentRoot
启动 Debug 时提示 “Waiting for incoming connection from Xdebug” 却一直卡住
这个提示看起来像 PhpStorm 在等连接，其实往往意味着 Xdebug 已尝试连接但失败——可能是端口被占、防火墙拦截、或 xdebug.client_host 指向错误。
尤其在 Windows + WSL2 或 macOS 使用 Docker 时，localhost 对 Xdebug 来说可能不是 PhpStorm 所在的宿主环境。
- 先运行
netstat -ano | findstr :9003（Windows）或lsof -i :9003（macOS/Linux），确认端口空闲 - 如果使用 WSL2，
xdebug.client_host应设为host.docker.internal或宿主 IP（如172.28.0.1），而非localhost - PhpStorm 的
Settings → PHP → Servers中，Host必须填localhost（不是127.0.0.1），且Port匹配 Apache 实际监听端口（如改过 8080，这里也要同步） - Chrome 安装
Xdebug Helper插件后，务必点击图标 →Debug启用，否则 Xdebug 不会触发连接
xdebug.remote_enable=1，实际会导致静默失效。真正要盯住的只有三件事：CLI Interpreter 路径是否准确、xdebug.mode=debug 是否生效、xdebug.client_host 是否指向 PhpStorm 所在机器的真实网络接口。 
