Sublime Text安装PHP开发环境搭建步骤-sublime-PHP中文网

sublime text 运行 php 依赖系统 php cli，必须先确保终端执行 php -v 成功；再配置 build system 和插件（如 php companion、sublimelinter-php）指向正确 php 路径，并处理 gui 环境变量不继承问题。

sublime text安装php开发环境搭建步骤

Sublime Text 本身不运行 PHP，所有功能都依赖系统已安装的 php CLI 可执行文件——没配好这个，后面装再多插件也白搭。

这是唯一前置条件，跳过它 90% 的问题都会复现。

打开终端（macOS/Linux）或命令提示符/PowerShell（Windows），执行：php -v
成功返回类似 PHP 8.2.12 才算过关；如果报 'php' is not recognized 或 command not found，说明 CLI 没装或没进 PATH
常见路径要记牢：/opt/homebrew/bin/php（macOS M1/M2 Homebrew）、C:\xampp\php\php.exe（Windows XAMPP）、/usr/bin/php（Ubuntu apt 安装）
GUI 启动的 Sublime（尤其是 macOS 和 WSL）经常不继承 shell 的 PATH，别只信“终端能跑，Sublime 就能跑”

这是最轻量、最可控的执行方式，不依赖插件，适合单文件调试。

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

粘贴以下内容（注意替换 cmd 中的路径为你本地真实的 php 路径）：

{
  "cmd": ["php", "-f", "$file"],
  "selector": "source.php",
  "file_regex": "^.*?on line ([0-9]+)",
  "working_dir": "$file_path"
}

保存为 PHP.sublime-build（自动存到 Packages/User/）
打开任意 .php 文件，按 Ctrl+B（Win/Linux）或 Cmd+B（macOS）即可在底部面板看到输出
常见坑：cmd 写成 ["php.exe"]（Windows 下若已加 PATH，不该带 .exe）；selector 缺失导致快捷键不生效；路径含空格却没用引号包裹

默认只认 .php，其他后缀（如 .phtml、.module）需手动关联；补全跳转失效，大概率是插件没指向正确的 php 二进制。

右下角点击当前语法名（如 Plain Text）→ Open all with current extension as → PHP，可临时解决
永久绑定：菜单 → Preferences → Settings – Syntax Specific → 在右侧加：
```
{"extensions": ["phtml", "module", "inc"]}
```
装 PHP Companion 后，必须配置 php_executable：菜单 → Preferences → Package Settings → PHP Companion → Settings - User → 填入你 which php 输出的绝对路径
装 SublimeLinter-php 后同样要设 php_executable：菜单 → Preferences → Package Settings → SublimeLinter → Settings → 用户设置里加：
```
"php_executable": "/opt/homebrew/bin/php"
```
补全范围受 vendor/autoload.php 加载影响，不是所有插件都支持 PSR-4 自动发现