PhpStorm找不到php命令的根本原因是GUI启动不继承shell环境变量，需先用which php或where php获取绝对路径，再在Settings→PHP→Interpreter中手动指定；macOS须用open -a PhpStorm启动，Windows需选php.exe而非php-cgi.exe。
PhpStorm 找不到 php 命令，不是它坏了，而是它压根没读你终端里配好的 PATH。GUI 启动时（macOS 从 Dock、Windows 从快捷方式），环境变量是空的。必须手动给它指一条明路。
怎么找到并填对 PHP 解释器路径
别信 Settings 里那个“自动检测”按钮——它大概率失败。
- 先在终端执行
which php（macOS/Linux）或where php（Windows），拿到绝对路径，例如/opt/homebrew/bin/php或C:\php\php.exe - 打开 Settings → Languages & Frameworks → PHP → Interpreter → 齿轮图标 → Add → Local → 点「…」选中上面那条路径
- 选完立刻看右下角是否显示类似
PHP 8.2.12 (cli)；不显示就说明路径错、文件没执行权限（Linux/macOS 需chmod +x /path/to/php），或 Windows 缺运行库（如msvcr120.dll） - macOS 用户务必用
open -a PhpStorm从终端启动，否则~/.zshrc里的PATH完全不生效
为什么 phpinfo() 和 PhpStorm 里 php --ini 显示的配置不一样
因为 Web（Apache/Nginx）和 CLI（命令行）用的是两套 php.ini，而 PhpStorm 默认调用 CLI 版本。
- 在 PhpStorm 内置 Terminal 里运行
php --ini，确认它实际加载的是哪个文件（常见路径：/etc/php/8.2/cli/php.ini或C:\php\php.ini） - Xdebug 必须装在 CLI 对应的
php.ini里，不是 Apache 那个；改错文件等于白配 - 检查
extension_dir指向的目录下是否有xdebug.so（Linux/macOS）或php_xdebug.dll（Windows） - Xdebug 3 最小必要配置只有三行：
zend_extension=xdebug、xdebug.mode=debug、xdebug.client_host=127.0.0.1，端口默认9003，别写成旧版9000
断点打了，“Start Listening”也点了，就是不中断
八成是服务器路径映射没对上——Xdebug 发来的调试请求被 PhpStorm 当成陌生访客直接丢弃了。
立即学习“PHP免费学习笔记（深入）”；
- 进 Settings → Languages & Frameworks → PHP → Servers，添加或检查已有服务器配置
- Host 填
localhost，端口填你 Web 服务实际监听的（比如 Apache 是80，Nginx 是8080） - 务必勾选
Use path mappings，把项目根目录（如/Users/name/project）映射到 Web 路径（如/或/myapp），两者必须严格匹配浏览器访问 URL 的路径结构 - 如果用 phpStudy/XAMPP/MAMP，映射目标通常是它的
www或htdocs子目录，不是整个安装路径
Composer 报 command not found 怎么办
PhpStorm 的 Composer 设置和 PHP 解释器设置完全独立，GUI 启动时也不会复用 shell 的 PATH。
- Settings → Languages & Frameworks → PHP → Composer，勾选
Use composer executable - 填入
which composer的真实路径，例如/opt/homebrew/bin/composer（Mac Homebrew）或C:\Users\YourName\scoop\shims\composer.bat（Windows Scoop） - 路径里不能有空格或中文，否则 PhpStorm 会静默失败（比如
C:\Program Files\...就不行） - 如果项目用
composer.phar，直接指向那个文件即可，不用全局安装
最常被忽略的其实是路径映射和 CLI 与 Web 的 php.ini 分离——这两处一错，调试和运行就会变成两个世界。别跳过 php --ini 和浏览器里 phpinfo() 的比对，那是唯一能确认你在改对文件的地方。
