Sublime Text 需调用系统已安装的 PHP 可执行文件，非自带环境；须先确认 php -v 可运行，再配置 Build System 运行脚本或内置服务器，不提供断点调试等 IDE 功能。

Sublime Text 本身不带 PHP 运行环境，所谓“配置 PHP 开发环境”，本质是让 Sublime 能调用系统已安装的 php 可执行文件来执行脚本，或配合外部服务（如内置服务器）调试。它不是 IDE，不提供断点、变量监视等能力。

确认本地已安装 PHP 并可命令行调用

这是最常被跳过的一步——Sublime 不会帮你装 PHP，只负责调用。如果 php -v 在终端/命令提示符中报 “command not found” 或 “不是内部或外部命令”，后续所有配置都无效。

• Windows 用户：检查 php.exe 所在路径是否已加入系统 PATH（比如 C:\php），并在 CMD 中运行 where php 验证
• macOS/Linux 用户：运行 which php，确保返回类似 /usr/bin/php 或 /opt/homebrew/bin/php 的路径
• 若未安装，请先从 windows.php.net（Win）或 brew install php（macOS）安装，不要试图用 Sublime 插件“替代”这步

用 Build System 直接运行 PHP 脚本

这是最快验证代码能否执行的方式，适合写小工具、测试逻辑，但无法处理 $_GET、$_POST 或路由。

操作路径：Tools → Build System → New Build System…，粘贴以下内容并保存为 PHP.sublime-build（默认位置即可）：

{
    "cmd": ["php", "-f", "$file"],
    "selector": "source.php",
    "file_regex": "php$"
}

• "cmd" 中的 php 必须能被系统识别；若 PHP 不在 PATH，需写绝对路径，如 ["C:/php/php.exe", "-f", "$file"]（Windows）或 ["/opt/homebrew/bin/php", "-f", "$file"]（macOS）
• "-f" 参数明确指定执行文件，避免因 PHP 版本差异导致解析失败
• 保存后，在 PHP 文件中按 Ctrl+B（Win/Linux）或 Cmd+B（macOS）即可看到输出（底部面板）

用 PHP 内置服务器预览网页（支持 $_GET 等）

想测试表单提交、URL 参数、简单路由？得启动一个最小 HTTP 服务。PHP 5.4+ 自带 php -S，无需额外装 Apache/Nginx。

新建另一个 Build System（例如 PHP-Server.sublime-build）：

{
    "cmd": ["php", "-S", "localhost:8000", "-t", "$file_path"],
    "selector": "source.php",
    "working_dir": "$file_path",
    "variants":
    [
        {
            "name": "Stop Server",
            "cmd": ["taskkill", "/F", "/IM", "php.exe"]
        }
    ]
}

• -t "$file_path" 指定文档根目录为当前文件所在文件夹，这样 index.php 和 test.php 都能通过 http://localhost:8000/test.php 访问
• Windows 下 taskkill 是粗暴关进程的方式，实际开发建议另开终端手动 Ctrl+C 停止；macOS/Linux 可改用 pkill -f "php -S"
• 浏览器访问前，确保没有其他程序占用了 8000 端口（如另一实例、Vagrant、Docker）

别指望 Sublime 做 IDE 的事

它没有 PHP 语言服务（LSP）时，就没有自动补全函数参数、跳转定义、实时语法校验等功能。如果需要这些，必须额外装插件（如 SublimeLSP + intelephense 或 phpactor），且要单独配置 PHP 分析器路径、索引范围等。

很多教程把“装插件→点几下设置→就变成 PHP IDE”当默认前提，但真实情况是：90% 的报错源于 php 命令不可达、路径含中文、权限不足，或插件根本没连上后台服务。先确保 php -v 和 php -l yourfile.php 在终端里跑通，再折腾 Sublime 的花活。