必须先确保php命令在终端中可用,否则sublime所有php功能将静默失败;运行php -v验证,若报错则需配置path或使用绝对路径。

php 命令必须能在终端里直接执行,否则 Sublime 所有 PHP 功能都会静默失败——这不是 Sublime 的问题,是环境没配对。
确认 php 在终端可用是唯一前提
打开终端(macOS/Linux)或 CMD/PowerShell(Windows),输入:php -v
如果返回类似 PHP 8.2.12 的版本号,说明 CLI 已就位;若报 command not found 或 'php' is not recognized,别往下走,先解决这个。
常见路径:
- macOS Homebrew:
/opt/homebrew/bin/php(M1/M2)或/usr/local/bin/php(Intel) - Windows XAMPP:
C:/xampp/php/php.exe(注意:Sublime 构建系统里写路径时,用正斜杠或双反斜杠都行,单反斜杠会解析错误) - Linux(apt):
/usr/bin/php
Windows 用户最容易漏掉的是:安装 XAMPP 后没把 C:\xampp\php 加进系统 PATH 环境变量;macOS 用户则常因从 Dock 启动 Sublime,导致它读不到 shell 配置里的 PATH——建议直接在终端执行 subl . 启动编辑器。
用 Build System 运行 PHP 文件,php -f $file 是核心
Sublime 不运行 PHP,它只是调用你系统的 php 命令。构建系统就是告诉它“怎么调”。
操作路径:
菜单栏 → Tools → Build System → New Build System…
粘贴以下内容并保存为 PHP.sublime-build(自动存到 Packages/User/):
{ "cmd": ["php", "-f", "$file"], "selector": "source.php", "working_dir": "$file_path" }
关键点:
-
-f参数强制指定文件执行,避免php $file被误解析为传参 -
"selector": "source.php"必须写,否则快捷键 Ctrl+B / Cmd+B 对非 PHP 文件也生效,或根本不触发 - Windows 下如果
php不在PATH中,得写绝对路径:"cmd": ["C:/xampp/php/php.exe", "-f", "$file"] - 文件含中文且 Windows 下报
Parse error?加一行:"encoding": "cp936"
语法检查靠 SublimeLinter-php,但得显式配 php_path
SublimeLinter 是框架,SublimeLinter-php 是插件,两者都要装。但装完常没反应——因为 GUI 启动的 Sublime 默认不继承终端的 PATH。
解决办法:显式指定 PHP 目录路径。
Preferences → Package Settings → SublimeLinter → Settings(右侧面板,用户设置)中填:
{ "paths": { "linux": [], "osx": ["/opt/homebrew/bin"], "windows": ["C:/xampp/php"] } }
注意:paths 填的是目录,不是 php 可执行文件本身;填完重启 Sublime。
验证方式:新建一个 .php 文件,故意写错语法(比如漏分号),保存后看底部状态栏是否弹出错误提示。如果控制台(Ctrl+`)里还显示 php: command not found,说明路径仍不对。
补全和跳转别信默认行为,Intelephense 需要项目结构支撑
原生 Sublime 对 PHP 几乎零支持。Intelephense 是目前最稳的补全/跳转方案,但它不是“装完就灵”。
必须满足:
- 通过 Package Control 安装,不能手动丢文件夹
- 项目根目录下要有
composer.json或至少一个vendor/autoload.php,否则连echo都不提示 - 用了自定义命名空间?得在项目根目录建
.intelephense.json,配"files.associations"和"environment.includePaths" - 首次索引很慢,状态栏显示
Indexing...时别关窗口,否则下次打开又重来
调试别指望 Sublime 内置能力——它没有真正的调试器。Xdebug Client 或 Debugger 插件只是接收器,断点生效依赖三端对齐:php.ini 开 xdebug.mode=debug、IDE key 设为 SUBLIME、浏览器装 Xdebug Helper 插件并开启调试模式。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











