Atom本身不运行PHP，仅调用系统php命令或封装php -S；常见卡住因PATH隔离、未设默认语法、PHP 8.1+反射失效或Atom版本低于1.50。
Atom 本身不运行 PHP，它只是调用系统已安装的 php 命令或启动 php -S 内置服务器 —— 所以“运行 PHP”本质是配置好 CLI 环境 + 选对插件，而不是靠 Atom 自带功能。
为什么 php -S 在 Atom 里点一下就卡住或没反应
常见现象：装了 php-server 插件，右键 → Start PHP Server，浏览器打不开，终端也没输出；或者地址显示 http://localhost:8000/index.php 但返回 404 或直接空白。
-
php-server只是封装了php -S localhost:8000，不处理路由、不监听文件变化、不自动刷新页面 - 它默认以当前打开的文件所在目录为 Web 根目录，但
php -S要求显式指定路由器脚本（如-t ./public router.php），否则只服务当前文件，且不支持子路径 - 如果项目结构是
src/+public/index.php，直接在src/里点 Start，php -S就会把src/当根目录，找不到public/下的资源 - macOS / Linux 上若用 Homebrew 安装 PHP，GUI 启动的 Atom 读不到 shell 的 PATH，
php -S命令可能根本执行不了（Dev Tools Console 里会报spawn php ENOENT）
linter-php 报 “PHP executable not found” 怎么填对路径
这不是 PHP 坏了，是 Atom GUI 进程没继承终端环境变量。必须手动填绝对路径，且格式敏感。
- 终端执行
which php，比如输出/opt/homebrew/bin/php→ 在linter-php设置页的Executable Path栏直接粘贴这个完整路径，**不加引号、不加空格** - Windows（XAMPP）填
C:\xampp\php\php.exe；若路径含空格（如C:\Program Files\php\php.exe），Atom 设置框里仍只填路径本身，**不要加双引号**（引号是命令行用的，插件内部不解析） - 验证是否生效：新建
test.php，写<?php echo "x";（故意少一个?>），保存后看左下角是否标出Parse error；若没反应，说明路径还是错的
想真正“运行整个项目”，别依赖 php-server
php-server 只适合单文件快速验证逻辑，比如写个 calc.php 算个数。复杂项目（Laravel、Symfony、含重写规则的）必须换方式。
立即学习“PHP免费学习笔记（深入）”；
- 用终端手动启：进项目根目录，执行
php -S localhost:8000 -t public router.php（Laravel 的router.php可简化为public/index.php） - 配合
atom-build插件，在项目根目录建.atom-build.json，内容如：{ "cmd": "php", "args": ["-S", "localhost:8000", "-t", "public", "public/index.php"], "sh": true }然后按Cmd+Alt+B（macOS）或Ctrl+Alt+B（Win/Linux）一键启 - 如果需要热重载，
php-server不行，得上nodemon+ 自定义脚本，例如：nodemon --exec php -S localhost:8000 -t public public/index.php
容易被忽略的关键点
很多人反复重装插件却失败，其实卡在三个静默环节：language-php 没设为默认语法（右下角点 PHP → Save as Default for .php）、autocomplete-php 在 PHP 8.1+ 上因反射 API 变更而静默失效（Dev Tools Console 里看有没有 ReflectionException）、以及所有插件都要求 Atom 版本 ≥ 1.50 —— 2026 年还在用 1.4x 的旧版 Atom，插件根本不会加载。
