首先确认PHP已安装并加入系统路径,再在Sublime Text中创建PHP构建系统:打开Tools→Build System→New Build System,输入对应系统的JSON配置,保存为PHP.sublime-build;之后打开.php文件按Ctrl+B或Cmd+B即可在底部面板查看运行结果,若报错需检查环境变量、文件保存状态及路径合法性。

在Sublime Text中运行PHP文件,需要先正确配置PHP环境,然后通过构建系统(Build System)来执行PHP脚本。整个过程不复杂,只要确保PHP已安装并加入系统路径,再设置Sublime的构建命令即可。
1. 确认PHP环境已安装并可执行
在使用Sublide运行PHP前,必须确保你的电脑已经安装了PHP,并且可以在命令行中直接运行php命令。
- 打开终端(Windows:cmd 或 PowerShell;macOS/Linux:Terminal)
- 输入 php -v 并回车
- 如果显示PHP版本信息(如 PHP 8.1.2),说明环境配置正确
- 如果没有提示,需下载PHP并将其安装目录添加到系统PATH环境变量中
2. 在Sublime中配置PHP构建系统
Sublime通过“Build System”来调用外部程序执行代码。我们需要新建一个针对PHP的构建配置。
- 打开 Sublime Text
- 点击顶部菜单栏的 Tools → Build System → New Build System…
- 会打开一个JSON格式的配置文件,将内容替换为以下代码(根据系统选择):
Windows 用户:
立即学习“PHP免费学习笔记(深入)”;
{
"cmd": ["php", "$file"],
"selector": "source.php",
"file_regex": "^.+?\\((\\d+)\\):(.*)$",
"working_dir": "$file_path"
}
macOS / Linux 用户:
{
"cmd": ["php", "$file"],
"selector": "source.php",
"file_regex": "^.+?\\((\\d+)\\):(.*)$",
"working_dir": "$file_path"
}
- 保存文件,命名为 PHP.sublime-build,默认会保存到配置目录中
3. 运行PHP文件
配置完成后,就可以在Sublime中直接运行PHP脚本了。
- 打开一个 .php 文件
- 按下 Ctrl + B(Windows/Linux)或 Cmd + B(macOS)
- Sublime会在底部输出面板中显示PHP执行结果
- 如果有语法错误或运行时错误,也会一并显示出来
4. 常见问题与注意事项
如果运行失败,可以从以下几个方面排查:
- 确认 php 是否在系统PATH中,可在任意终端位置运行 php -v
- 检查PHP构建文件是否保存正确,后缀必须是 .sublime-build
- 确保当前文件已保存(Sublime不会执行未保存的临时文件)
- 如果路径含中文或空格,建议移动到简单路径下测试
基本上就这些。配置一次后,以后所有PHP文件都可以通过 Ctrl+B 快捷运行,适合学习和调试小脚本。对于复杂项目,建议搭配本地服务器环境(如XAMPP、Laravel Valet等)。











