Sublime Text中PHP开发需分层配置:语法高亮(ST4自带)、PHP Companion(快捷代码生成)、SublimeLinter-php(依赖本地php命令的语法检查);高级补全需LSP插件+intelephense服务器,且依赖composer.json和vendor目录。

PHP插件在Sublime Text里不是“装一个就完事”的概念
Sublime Text 本身不内置 PHP 运行环境,所谓“PHP 插件”通常指三类东西:PHP syntax highlighting(语法高亮)、PHP code completion(补全)、PHP linting / formatting(语法检查或格式化)。它们依赖不同机制,不能靠一个插件包全解决。
Package Control 是唯一靠谱的安装入口
别手动下载 ZIP 解压到 Packages/ 目录——容易路径错、版本旧、更新断。必须用 Package Control 管理:
- 没装过?用
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)调出命令面板,输入Install Package Control并回车,等几秒自动完成 - 已装好?再按一次
Ctrl+Shift+P,输入Package Control: Install Package,回车后等待仓库列表加载 - 搜索时直接输
php,别输全名——比如搜phpcs找不到,搜phpcs对应的插件名其实是PHP CodeSniffer,但搜php就能刷出来
推荐装这 3 个插件,覆盖核心需求
别贪多。以下组合实测稳定、更新勤、冲突少:
-
PHP Syntax Highlighting:Sublime Text 4 自带,无需额外装;若用 ST3 且 PHP 文件没高亮,说明
PHP没设为默认语法——右下角点击当前语法名(如Plain Text),选PHP - PHP Companion:提供
__construct快速生成、use语句自动补全、die(var_dump())一键包裹等实用功能,不依赖外部 CLI 工具 - SublimeLinter-php:需本地已装
php命令(终端运行php -v能返回版本号),它调用php -l做语法检查;若报错Could not locate php,得在插件设置里填绝对路径,比如 Windows 是C:\\xampp\\php\\php.exe,macOS 可能是/usr/local/bin/php
补全和格式化要另配 PHP Language Server
原生 Sublime 不支持 LSP(Language Server Protocol),所以想用 intelephense 或 phpactor 这类现代补全/跳转/重构能力,必须装 LSP 插件 + 对应服务器:
立即学习“PHP免费学习笔记(深入)”;
- 先装
LSP插件(Package Control 里搜LSP) - 再装
LSP-intelephense(推荐)或LSP-phpactor(需额外配置phpactorCLI) - 关键点:
intelephense首次启动会下载二进制文件,耗时且可能卡在防火墙后——如果状态栏一直显示Starting intelephense...,去Preferences → Package Settings → LSP-intelephense → Settings,把"download": true改成false,手动下载对应平台的intelephense二进制并填入"binary_path"
{
"binary_path": "/Users/you/intelephense/intelephense",
"download": false
}
PHP 补全质量高度依赖 composer.json 和 vendor/ 是否存在,项目根目录没这两个,LSP-intelephense 只能猜基础函数。











