本地 PHP 解释器、Composer 和 Xdebug 三者必须配齐且协同工作，才是 PhpStorm 中真正可用的 PHP 开发环境；仅配解释器无法运行 composer install，仅装 Xdebug 未在对应 php.ini 中启用则断点不生效，且三者路径、版本、SAPI 类型（CLI/Web）必须严格匹配。
直接说结论：本地 PHP 解释器 + Composer + Xdebug 三者配齐，才是 PhpStorm 中真正可用的 PHP 开发环境。只配解释器，连 composer install 都跑不起来；只装 Xdebug 却没在 php.ini 里启用，断点永远不生效。
PHP 解释器必须指向真实可执行文件，不能只填目录
常见错误是把 php 目录路径（比如 C:\php）直接填进 PhpStorm 的 PHP 解释器设置里——这会报错 Cannot determine PHP version。PhpStorm 要的是具体二进制文件路径：
- Windows：填
C:\php\php.exe（不是C:\php） - macOS：用
which php查到的是/usr/local/bin/php，就填这个完整路径 - Linux：确认
php -v可运行后，填/usr/bin/php或/opt/php/bin/php
如果 PhpStorm 提示 “No PHP executable found”，先在终端执行 php -v 验证是否真能调用；若失败，说明系统 PATH 没配对，得先修 PATH，再回 PhpStorm 点刷新按钮。
Composer 必须全局可用，且 PhpStorm 要识别其位置
PhpStorm 依赖 Composer 执行依赖安装、自动补全、框架支持（如 Laravel Facades）。它不会自己下载或安装 Composer，只读取你已有的 composer 命令：
立即学习“PHP免费学习笔记（深入）”；
- 验证方式：终端执行
composer -V，必须输出版本号 - Windows 下用官方安装器（
Composer-Setup.exe）更稳妥，避免手动移动composer.phar后权限或路径出错 - macOS/Linux 推荐用
brew install composer，而非curl | php方式，后者容易因权限问题导致composer不在 PATH - PhpStorm 设置路径：Preferences → PHP → Composer → “Path to composer.phar” 选自动检测，或手动填
/usr/local/bin/composer
如果项目右键菜单里没有 “Composer → Install dependencies”，说明 PhpStorm 根本没认出 Composer，别急着建项目，先修这个。
Xdebug 配置必须匹配 PHP 版本和 SAPI 类型
断点不触发？变量不显示？大概率是 Xdebug 版本与 PHP 不兼容，或 php.ini 加载错了：
- 先运行
php -m | grep xdebug，确认扩展已加载；若无输出，说明没启用 - 查 PHP 实际加载的
php.ini：执行php --ini，只改那个文件，别改错位置（比如改了 CLI 的，但 Web Server 用的是另一个） - PHP 8.0+ 推荐用 Xdebug 3.x，配置项全变了：
xdebug.mode=debug+xdebug.client_host=127.0.0.1，旧版的xdebug.remote_enable=1已失效 - PhpStorm 调试监听端口默认是 9003，Xdebug 3.x 默认也是 9003，但必须确保两者一致；若改过，两边都要同步
一个常被忽略的点：CLI 和 Web SAPI 的 php.ini 是两套。调试命令行脚本时，要确认 CLI 的 php.ini 里启用了 Xdebug；调试网页请求时，则要检查 Apache/Nginx 使用的 php.ini。
部署配置不是必须项，但内置 PHP Server 适合快速验证
刚写完 index.php 想立刻看效果？不用搭 Apache/Nginx：
- 右键项目 → “Open in Browser” 会失败，因为没服务器
- 正确做法：菜单栏 Run → “Start Built-in Web Server”，指定端口（如 8000），根目录选项目路径
- 此时访问
http://localhost:8000就能跑 PHP 文件，且支持路由重写（需勾选 “Use router script” 并指定router.php） - 注意：内置服务器不支持
.htaccess，也不处理静态资源缓存，仅用于开发验证，别当生产用
真正的难点不在“怎么配”，而在于每个组件都依赖前一个环节正常工作：PHP 解释器挂了，Composer 和 Xdebug 都白装；PATH 错了，PhpStorm 就找不到任何命令。排查时务必从 php -v → composer -V → php -m | grep xdebug 逐级验证，跳步等于白忙。
