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(默认位置即可):
立即学习“PHP免费学习笔记(深入)”;
{
"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 的花活。











