PhpStorm不运行PHP，仅调用本地php可执行文件；配置失败主因是路径错误或未安装PHP，需用which php/where php获取绝对路径，在Settings→PHP→Interpreter中手动指定，并确保CLI的php.ini启用Xdebug且端口为9003。
PHPStorm 本身不运行 PHP，它只调用你本地装好的 php 可执行文件——配置失败，90% 是路径没对上，或者根本没装 PHP。
怎么确认 PhpStorm 能真正找到并调用 php
别信终端里 php -v 能跑就万事大吉。GUI 启动的 PhpStorm（比如 macOS 从 Dock 点开、Windows 用快捷方式）默认不继承 shell 的 PATH，which php 的结果它根本看不到。
- 先在终端执行
which php（macOS/Linux）或where php（Windows），拿到绝对路径，例如/opt/homebrew/bin/php或C:\php\php.exe - 进 Settings → Languages & Frameworks → PHP → Interpreter → 齿轮图标 → Add → Local → 用「…」手动选中上面那条路径里的
php文件 - 选完立刻看右下角是否显示类似
PHP 8.2.12 (cli)；不显示就说明路径错、权限不足（Linux/macOS 需chmod +x /path/to/php），或依赖缺失（Windows 常见缺msvcr120.dll） - Mac 用户特别注意：用
open -a PhpStorm从终端启动，才能读取~/.zshrc中的环境变量
为什么 test.php 能 Run 却不能 Debug
CLI 解释器和 Xdebug 是两套逻辑。配了 php 路径 ≠ Xdebug 自动生效。
- 在 PhpStorm 内置 Terminal 里运行
php --ini，确认它实际加载的是哪个php.ini—— 很可能和浏览器里phpinfo()显示的不是同一个文件 - Xdebug 必须装在 CLI 对应的
php.ini里，不是 Apache/Nginx 那个。常见位置：/etc/php/8.2/cli/php.ini（Ubuntu）、/opt/homebrew/etc/php/8.2/php.ini（Mac Homebrew） - 检查
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 for PHP Debug Connections”，断点也打了，但就是不中断——大概率是路径映射没对上，Xdebug 发起的连接被 PhpStorm 当成未知请求丢弃了。
- 进 Settings → Languages & Frameworks → PHP → Servers，新建一个服务器
- 主机填
localhost，端口按你本地 Web 服务实际用的填（如80、8080或8000） - 务必勾选 “Use path mappings”
- 把你的项目根目录（如
/Users/name/project）映射到 Web 根路径（如/或/project/），映射关系必须和浏览器访问 URL 时的真实路径一致
composer 报 command not found 怎么办
PHPStorm 默认不复用 shell 的 PATH，尤其 GUI 启动时，它不会自动从 $PATH 里找 composer。
- 进 Settings → Languages & Frameworks → PHP → Composer
- 勾选 “Use composer executable”
- 填上
which composer的结果，例如/opt/homebrew/bin/composer - Windows 上如果用 Scoop 安装，路径可能是
C:\Users\YourName\scoop\shims\composer.bat；别用带空格的路径（如C:\Program Files），PHPStorm 会静默失败
最常被忽略的其实是 CLI 和 Web SAPI 的 php.ini 分离这件事——改错了文件，所有调试配置都白搭。动手前先跑一遍 php --ini 和 php -m | grep xdebug，比反复重启 PhpStorm 有用得多。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
