PhpStorm运行PHP脚本需正确配置解释器并选择合适运行方式：解释器须指向系统PHP可执行文件且路径无中文或空格；运行方式分PHP Script（CLI环境，适合语法测试）和Built-in Web Server（Web环境，适合调试路由与API）。
PhpStorm 里跑 PHP 脚本，核心就两件事：解释器得配对、运行方式得选对。配错解释器，php -v 能跑，但 PhpStorm 里点 Run 却报 PHP interpreter is not configured；选错运行类型，比如该用 PHP Script 却建了 PHP Web Page，结果浏览器打不开、控制台没输出。
确认本地 PHP 解释器已正确绑定到 PhpStorm
这是所有后续操作的前提。PhpStorm 不自带 PHP，它只是调用你系统里的 php 可执行文件。
- 终端执行
php -v，有版本输出才算通过；若报 command not found，先装 PHP 或配 PATH - 路径不能含中文或空格——
C:\Program Files\php\php.exe很大概率失败，建议解压到C:\php\这类纯英文路径 - Settings → Languages & Frameworks → PHP → Interpreter → Add → Local → 浏览选择
php.exe（Windows）或/usr/bin/php（macOS/Linux） - 配完后右下角状态栏应显示 PHP 版本号，且
CLI Interpreters也指向同一路径，避免 Terminal 里php --version和编辑器内提示不一致
用 PHP Script 类型直接运行单个文件
适合验证语法、快速测试函数逻辑、执行 CLI 工具脚本，无需 Web 环境。
- 右键任意
.php文件 → Run '.php'，会自动生成一个临时 PHP Script配置 - 若要复用或修改参数（如传
$argv），进 Run → Edit Configurations → 找到对应配置 → 检查Script path是否正确，Arguments栏可填命令行参数 - 注意：此方式不走 Web Server，
$_SERVER数组内容极简，$_GET/$_POST为空，别指望它模拟 HTTP 请求
用 Built-in Web Server 启动项目入口
适合调试路由、API 返回、HTML 渲染，比配 Apache/Nginx 轻量得多，断网也能用。
立即学习“PHP免费学习笔记（深入）”；
- 确保项目根目录下有
index.php（哪怕只写<?php echo 'ok'; ?>） - 右键
index.php→ Run '.php'，PhpStorm 自动执行 php -S localhost:8000 -t . - 端口被占？Settings → Languages & Frameworks → PHP → Built-in Web Server → 修改
Port（如改成8080） - 浏览器访问
http://localhost:8000即可；但注意：不支持.htaccess、无重写规则，复杂路由需自己写router.php代理
为什么 test.php 输出了 phpinfo 却连不上 Xdebug？
因为运行模式和调试模式是两套机制。Run 是执行，Debug 是监听+通信，缺一不可。
-
phpinfo()有 Xdebug 模块 ≠ PhpStorm 调试能连上——必须同时满足：php.ini 里启用了zend_extension=xdebug+xdebug.mode=debug+xdebug.client_port=9003 - PhpStorm 必须点击顶部工具栏的电话图标（Start Listening for PHP Debug Connections）才开启监听
- 浏览器要配合 Xdebug Helper 插件开启调试，或手动加
?XDEBUG_SESSION_START=PHPSTORM参数 - 离线时 Xdebug 配置不会热加载，改了
php.ini必须重启 PHP 进程（关掉所有php -S进程再重开）
最常被忽略的是：Run 和 Debug 共享同一个解释器路径，但它们触发的是完全不同的 PHP 启动流程。Run 走的是 CLI SAPI，Debug 走的是 CGI/FPM SAPI（即使你用内置服务器），所以 php.ini 里 xdebug.mode 的生效范围、output_buffering 的行为都可能不同。别只测 Run 成功就认为环境全通了。
