针对PHP开发者的Sublime代码编辑器最佳环境配置手册-sublime-PHP中文网

sublime text 本身不运行 php，所有配置都是为调用系统已安装的 php cli；必须先在终端执行 php -v 成功，否则构建、语法检查等功能均失效；再通过新建 build system 配置 cmd 调用 php -f "$file" 并设置 selector 为 "source.php"，最后可扩展 .phtml 等后缀的语法识别。

针对php开发者的sublime代码编辑器最佳环境配置手册

Sublime Text 本身不运行 PHP，所有“配置环境”的动作，都是为了让它能调用你系统里已装好的 php 命令行程序（CLI）——如果终端里 php -v 都报错，Sublime 就不可能跑起来。

确认 `php` 命令在终端可用是唯一硬门槛

这不是可选项，而是所有后续配置生效的前提。很多构建失败、语法检查静默、补全不工作，根源都在这一步没走通。

打开终端（macOS/Linux）或 PowerShell（Windows），执行 php -v
成功返回类似 PHP 8.2.12 才算过关；若提示 command not found 或 'php' is not recognized，说明 CLI 未安装或 PATH 没配对
Windows 用户别信快捷方式右键“属性”里的路径——那是图形界面 PATH，Sublime 启动时未必继承；改用 Get-Command php 查真实位置
常见路径要记牢：/usr/bin/php（Linux apt）、/opt/homebrew/bin/php（macOS Homebrew）、C: mppphpphp.exe（Windows XAMPP）

用 Build System 实现 `Ctrl+B` 运行 PHP 脚本

这是最轻量、最可控的执行方式，不依赖插件，适合验证逻辑、跑小工具，但无法模拟 Web 请求（$_GET/$_POST 为空）。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

菜单栏 → Tools → Build System → New Build System…
粘贴以下内容（注意：Windows 下若 php 不在 PATH，必须写绝对路径，如 "C:\xampp\php\php.exe"；反斜杠要双写）：

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

-f 表示执行文件；换成 -l 可做语法检查（只报错不输出）
"selector": "source.php" 必须保留，否则按 Ctrl+B 时不会触发该构建系统
保存为 PHP.sublime-build（默认位置即可，会自动存到 Packages/User/）
之后打开任意 .php 文件，按 Ctrl+B（Windows/Linux）或 Cmd+B（macOS），结果直接出现在底部面板

让 `.phtml`、`.inc`、`.module` 等后缀也识别为 PHP

Sublime 默认只对 .php 后缀启用 PHP 语法高亮和构建系统，其他扩展名打开就是“Plain Text”，连 <?php 都不着色。

打开一个 .phtml 文件 → 右下角点击当前语法名（比如 “Plain Text”）→ 选择 “PHP”（临时生效）
永久绑定：菜单栏 → Preferences → Settings – Syntax Specific → 在右侧 JSON 中添加：

{ "extensions": ["phtml", "inc", "module", "install"] }

注意：不是 Settings – User，语法关联必须走 Settings – Syntax Specific，否则无效
这个配置只作用于当前文件类型，不影响全局行为

为什么 `php` 命令在终端能用，Sublime 却报 `command not found`

GUI 启动的 Sublime 往往不继承 shell 的完整 PATH，尤其在 macOS M1/M2 或 Windows WSL 下，这是最常被忽略的兼容性断点。

macOS 用户：Sublime 默认不读取 ~/.zshrc 或 ~/.bash_profile，解决方案有两个：
– 从终端启动 Sublime：open -a "Sublime Text"
– 或在 Build System 的 cmd 中直接写绝对路径，如 "/opt/homebrew/bin/php"
Windows 用户：某些安装包（如 XAMPP）只在图形界面加载 PATH，而 Sublime 是从快捷方式启动，解决办法是把 php.exe 所在目录（如 C: mppphp）加进系统环境变量，且确保重启 Sublime
路径含空格（如 C:Program Filesphpphp.exe）必须用引号包裹，否则 Windows 会解析失败
别在 cmd 里写成 ["php.exe"]——只要 php 已在 PATH，就不该加 .exe；加了反而可能去搜 php.exe.exe