PHP解释器路径必须为php.exe或php二进制文件的绝对路径，Xdebug需匹配PHP版本与SAPI，Composer路径须指向可执行文件而非目录；三者配置错误占新手失败八成。
PHP解释器路径必须指向php.exe或php二进制文件
PhpStorm 无法运行 PHP 代码的根本原因，90% 是解释器没配对。它不认 php 命令是否在终端可用，只认你手动指定的绝对路径。
常见错误现象：PHP Interpreter not configured 提示、Run Configuration 里 PHP Script 选项灰掉、右键 Run 'index.php' 报错“Cannot find PHP interpreter”。
- Windows 用户：路径类似
C:\php\php.exe（不是C:\php\目录，也不是php命令别名） - macOS 用户：用
which php查真实路径，通常是/usr/local/bin/php或/opt/homebrew/bin/php；如果用 XAMPP/MAMP，得找其自带的bin/php - Linux 用户：确认
php -v能执行后，再用readlink -f $(which php)拿到真实路径，避免符号链接失效
Composer 配置不是必须的，但影响依赖识别和代码提示
PhpStorm 不强制要求装 Composer，但一旦项目含 composer.json，没配好 Composer 就会导致：类自动导入失败、vendor/autoload.php 红波浪线、第三方包函数无补全、甚至单元测试运行报 Class not found。
关键点在于告诉 PhpStorm “Composer 可执行文件在哪”，而不是“是否装了 Composer”：
立即学习“PHP免费学习笔记（深入）”；
- 路径填的是
composer.phar或全局安装的composer二进制（如/usr/local/bin/composer），不是目录 - 若用 Homebrew 安装的 Composer，路径通常为
composer（系统已加入 PATH），但 PhpStorm 有时读不到，建议填绝对路径 - 配置位置：
Settings > PHP > Composer，勾选Enable composer integration
Xdebug 必须与 PHP 版本和 SAPI 匹配，否则断点不生效
配置完 Xdebug 后断点灰色、控制台没输出、调试按钮不可点——大概率是扩展版本不兼容。Xdebug 3.x 不兼容 PHP 7.2 以下，Xdebug 4 尚未发布，当前主流是 Xdebug 3.3+ 配 PHP 8.1–8.3。
验证步骤比配置更重要：
- 在终端运行
php -v和php -m | grep xdebug，确认模块已加载 - 检查
php.ini中是否启用：必须有zend_extension=xdebug（不是extension=），且路径正确 - PhpStorm 中设置需对应：进入
Settings > PHP > Debug，Debugger Port 默认是9003（Xdebug 3+），不是旧版的9000 - 浏览器插件（如 Xdebug Helper）要开启，并确保请求带
XDEBUG_SESSION_START=PHPSTORM参数
内置 Web Server 适合开发，但不能替代真实环境
PhpStorm 自带的 PHP Built-in Web Server 开箱即用，但仅用于快速预览和单文件调试。它不支持 .htaccess、URL 重写、多域名、HTTPS 或复杂路由规则。
典型问题场景：
- Laravel 的
public/index.php能跑，但访问/login返回 404（因为没配 rewrite） - WordPress 后台登录后跳转失败（依赖 Apache mod_rewrite）
- 前端资源（CSS/JS）404，因静态文件路径解析逻辑不同
解决办法：用 Docker 或本地 Apache/Nginx；若坚持用内置服务，可在 Run > Edit Configurations > PHP Built-in Web Server 中设置 Document root 为 public/（Laravel）或 web/（Symfony），并手动加路由脚本。
test.php 输出 phpinfo()，再点右上角 ▶️ 运行，看到页面才算真正走通。 
