Sublime Text如何配置PHP开发环境？实用插件安装方法-sublime-PHP中文网

Sublime Text 运行 PHP 的前提是系统已安装并正确配置 php CLI，终端执行 php -v 成功是唯一前置条件；随后需配置 Build System（如 PHP.sublime-build）调用 php 解释器，再安装 PHP Companion、SublimeLinter-php 和 LSP-intelephense 插件以实现补全、语法检查与调试。

sublime text如何配置php开发环境？实用插件安装方法

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

确认终端能跑 `php -v` 是唯一前置条件

别跳过这步，GUI 启动的 Sublime（尤其是 macOS 和 WSL）经常不继承 shell 的 PATH，终端能跑 ≠ Sublime 能跑。

打开终端（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 安装）

用 Build System 直接运行 `.php` 文件最可靠

不依赖插件，适合单文件调试，也是后续插件功能（如 linting、补全）正常工作的基础。

菜单 → Tools → Build System → New Build System…

粘贴以下内容（注意把 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 缺失导致快捷键不生效；路径含空格却没用引号包裹

只装这 3 个插件，覆盖核心需求

贪多易冲突、更新断、配置乱。以下组合实测稳定、更新勤：

btpanel phpsite 宝塔面板PHP网站

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

下载

PHP Companion：提供 __construct 快速生成、use 自动补全、die(var_dump()) 一键包裹等，不依赖外部 CLI 工具
SublimeLinter-php：需本地有 php 命令，它调用 php -l 做语法检查；若报错 Could not locate php，得在插件设置里填绝对路径（如 Windows 是 C:\xampp\php\php.exe）
LSP-intelephense（非必需但强烈推荐）：现代补全/跳转/重构能力的核心；首次启动会下载二进制，若卡在 Starting intelephense，去设置里把 "download": true 改成 false，手动下载并填入 "binary_path"

语法高亮和后缀绑定常被忽略

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

右下角点击当前语法名（如 Plain Text）→ Open all with current extension as → PHP，可临时解决
永久绑定：菜单 → Preferences → Settings – Syntax Specific → 在右侧加：
```
{"extensions": ["phtml","module","inc"]}
```
PHP Companion 和 SublimeLinter-php 都要单独设 php_executable：前者在 Preferences → Package Settings → PHP Companion → Settings - User；后者在 Preferences → Package Settings → SublimeLinter → Settings，填入 which php 输出的绝对路径