必须手动指定php可执行文件绝对路径，因PhpStorm GUI启动不继承shell环境变量；macOS/Linux用which php、Windows用where php获取路径，再在Settings→PHP→Interpreter中添加，选php.exe或对应二进制文件，避免选目录。
必须手动指定 php 可执行文件的绝对路径，PhpStorm 不会自动继承终端里的 PATH，GUI 启动时尤其容易失效。
怎么找到正确的 php 路径
别信系统环境变量是否“看起来正常”——PhpStorm 的 GUI 进程不读 shell 配置文件（比如 ~/.zshrc 或 PATH 注册表项）。
- macOS/Linux：在终端运行
which php，结果类似/opt/homebrew/bin/php或/usr/local/bin/php - Windows：运行
where php，结果类似C:\php\php.exe或C:\xampp\php\php.exe（注意必须是.exe文件，不是文件夹） - 如果命令报错或无输出，说明 PHP 没装好或没加进系统
PATH，先解决这个再进 PhpStorm
在 PhpStorm 里添加 Interpreter 的实操要点
Settings → Languages & Frameworks → PHP → Interpreter → 点齿轮 → Add → Local → … → 手动选中上面拿到的完整路径。
- 路径填错的典型表现：
Cannot run program "php"或版本号为空；常见错误是选了目录（如C:\xampp\php），而不是php.exe - macOS 用户用 Dock 启动 PhpStorm 时，
which php在终端能跑，但 PhpStorm 找不到——改用终端命令open -a PhpStorm启动，才能加载 shell 环境 - Linux/macOS 下若提示 permission denied，给文件加执行权限：
chmod +x /path/to/php - 点 OK 后右下角显示
PHP 8.2.12 (cli)才算成功；否则检查路径、权限、依赖库（如 Windows 缺msvcr120.dll）
为什么 test.php 能 Run 却不能 Debug
Run 和 Debug 是两套机制：Run 只需要 Interpreter 路径正确；Debug 必须额外满足 Xdebug 在 CLI 模式下启用，且配置匹配。
立即学习“PHP免费学习笔记（深入）”；
- 在 PhpStorm 的 Terminal 里运行
php --ini，确认它加载的是 CLI 版本的php.ini（不是 Apache/Nginx 的那个） - 编辑对应
php.ini，只加这三行就足够启动调试：zend_extension=xdebug、xdebug.mode=debug、xdebug.client_host=127.0.0.1 - Xdebug 3 默认端口是
9003，不是旧版的9000；PhpStorm 的 Debug 配置页也要保持一致 - 改完
php.ini后必须重启 PhpStorm，再用php -m | grep xdebug验证扩展已加载
Web 服务器映射配错会导致断点完全不触发
很多人点了 “Start Listening for PHP Debug Connections”，打了断点，但请求一发就过——根本原因是 URL 路径和本地文件路径没对上，Xdebug 发起的调试连接被 PhpStorm 当成未知请求丢弃了。
- Settings → PHP → Servers → + → 填
Host为localhost（不要带http://），Port填你实际用的端口（如80或8000） - 务必勾选
Use path mappings，然后填：Server path 是 Web 根目录的绝对路径（如/var/www/html或C:\xampp\htdocs），Project path 是你当前项目的根目录（通常自动填好） - 映射关系必须严格一一对应：浏览器访问
http://localhost/test.php，就得确保该 URL 对应到你项目里test.php的真实磁盘路径 - 这个配置只影响网页调试和 URL 补全，不影响 CLI 脚本运行
最常被忽略的其实是 CLI 和 Web SAPI 的 php.ini 分离问题——你在 Apache 的 php.ini 里开了 Xdebug，对 PhpStorm 完全无效；必须改 CLI 对应的那个文件，而且得重启 IDE 才生效。
