Sublime Text 需调用系统已安装的 PHP 可执行文件,非自带环境;须先确认 php -v 可运行,再配置 Build System 运行脚本或内置服务器,不提供断点调试等 IDE 功能。
Sublime Text 本身不带 PHP 运行环境,所谓“配置 PHP 开发环境”,本质是让 Sublime 能调用系统已安装的
可执行文件来执行脚本,或配合外部服务(如内置服务器)调试。它不是 IDE,不提供断点、变量监视等能力。
确认本地已安装 PHP 并可命令行调用
这是最常被跳过的一步——Sublime 不会帮你装 PHP,只负责调用。如果
在终端/命令提示符中报 “command not found” 或 “不是内部或外部命令”,后续所有配置都无效。
Windows 用户:检查
所在路径是否已加入系统
(比如
),并在 CMD 中运行
验证
mac
OS/Linux 用户:运行
,确保返回类似
或
的路径
若未安装,请先从
windows.php.net
(Win)或
(macOS)安装,不要试图用 Sublime 插件“替代”这步
用 Build System 直接运行 PHP 脚本
这是最快验证代码能否执行的方式,适合写小工具、测试逻辑,但无法处理
、
或路由。
操作路径:
Tools → Build System → New Build System…
,粘贴以下内容并保存为
(默认位置即可):
立即学习
“
PHP免费学习笔记(深入)
”;
Docker Sandbox
创建并管理 Docker 沙箱虚拟机环境以安全执行代理。适用于运行不受信任代码、探索包或隔离代理工作负载。支持 Claude、Codex、Copilot、Gemini 和 Kiro 代理,并提供网络代理控制。
下载
中的
必须能被系统识别;若 PHP 不在
,需写绝对路径,如
(Windows)或
(macOS)
参数明确指定执行文件,避免因 PHP 版本差异导致解析失败
保存后,在 PHP 文件中按
(Win/Linux)或
(macOS)即可看到输出(底部面板)
用 PHP 内置服务器预览网页(支持 $_GET 等)
想测试表单提交、URL 参数、简单路由?得启动一个最小 HTTP 服务。PHP 5.4+ 自带
,无需额外装 Apache/Nginx。
新建另一个 Build System(例如
):
指定文档根目录为当前文件所在文件夹,这样
和
都能通过
访问
Windows 下
是粗暴关进程的方式,实际开发建议另开终端手动
停止;macOS/Linux 可改用
浏览器
访问前,确保没有其他程序占用了
端口(如另一实例、Vagrant、Docker)
别指望 Sublime 做 IDE 的事
它没有 PHP 语言服务(LSP)时,就没有自动补全函数参数、跳转定义、实时语法校验等功能。如果需要这些,必须额外装插件(如
+
或
),且要单独配置 PHP 分析器路径、索引范围等。
很多教程把“装插件→点几下设置→就变成 PHP IDE”当默认前提,但真实情况是:90% 的报错源于
命令不可达、路径含中文、权限不足,或插件根本没连上后台服务。先确保
和
在终端里跑通,再折腾 Sublime 的花活。
phpphp -vphp.exePATHC:\phpwhere phpwhich php/usr/bin/php/opt/homebrew/bin/phpbrew install php$_GET$_POSTPHP.sublime-build
{
"cmd": ["php", "-f", "$file"],
"selector": "source.php",
"file_regex": "php$"
}
"cmd"phpPATH["C:/php/php.exe", "-f", "$file"]["/opt/homebrew/bin/php", "-f", "$file"]"-f"Ctrl+BCmd+Bphp -SPHP-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.phptest.phphttp://localhost:8000/test.phptaskkillCtrl+Cpkill -f "php -S"8000SublimeLSPintelephensephpactorphpphp -vphp -l yourfile.php