Sublime运行PHP环境配置_Sublime运行调试技巧【秘籍】-sublime-PHP中文网

sublime text 运行 php 依赖系统已安装的 php 命令行程序，需先确保终端执行 php -v 成功；若失败，须修复 path 环境变量，再配置构建系统并重启 sublime。

sublime运行php环境配置_sublime运行调试技巧【秘籍】

Sublime Text 本身不运行 PHP，所有“运行”动作都只是调用你系统里已安装的 php 命令行程序；如果终端里执行 php -v 都失败，Sublime 就不可能跑起来——别配构建系统，先解决这个。

这是 90% 运行失败的根源，不是 Sublime 的问题，而是环境没对齐。

在终端（macOS/Linux）或 CMD/PowerShell（Windows）中执行 php -v，必须看到类似 PHP 8.2.12 的输出
若报 'php' is not recognized（Windows）或 command not found: php（macOS/Linux），说明 php 不在 PATH 中
macOS Homebrew 用户：运行 which php，常见路径是 /opt/homebrew/bin/php（M1/M2）或 /usr/local/bin/php（Intel）；没输出就补装：brew install php
Windows XAMPP 用户：路径通常是 C:/xampp/php/php.exe，需把 C:/xampp/php（不含 .exe）加进系统环境变量 PATH，且重启 Sublime 进程（不是仅关窗口）
Linux（apt）用户：确保装的是 php-cli 包：sudo apt install php-cli；若仍报错，可能是多版本共存，试 php8.2 -v 确认实际命令名

Windows 下如果 php 已在 PATH 中，cmd 字段里写 ["php", "-f", "$file"] 即可；加 .exe 反而可能因找不到 php.exe.exe 报错。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

-f 参数很关键：它明确告诉 PHP 加载并执行指定文件，避免把 $file 当作 CLI 参数解析出错
路径含空格（如 C:/Program Files/php/php.exe）必须用引号包裹整个路径字符串，否则解析失败
GUI 启动的 Sublime（比如从 Dock 或开始菜单点开）往往不继承 shell 的完整 PATH，尤其 macOS M1/M2 和 Windows WSL 下；建议直接在终端执行 subl . 启动编辑器
漏掉 "selector": "source.php" 会导致快捷键对非 PHP 文件也响应，或完全不触发

Windows 控制台默认 GBK 编码，而 PHP CLI 输出 UTF-8，直接导致中文显示异常；这不是编码设置问题，是终端层面对接错位。

别硬改 Sublime 的 encoding 设置，优先启用 "shell": true 模式，让命令走系统 shell 而非直连控制台
若仍乱码，可在构建系统 JSON 中加 "encoding": "cp936"（仅限 Windows），但仅对输出有效，不影响语法解析
文件含 BOM 或以非 UTF-8 编码保存时，可能触发 Parse error: syntax error, unexpected ''；用 Sublime 的 File → Reopen with Encoding → UTF-8 重载再试
file_regex 字段影响错误行跳转能力，标准格式应匹配 Parse error:.*on line ([0-9]+)，否则点击错误不会跳转到对应行

语法检查插件报 php: command not found，和构建系统报错是同一根源：GUI 启动的 Sublime 没继承终端的 PATH。

进 Preferences → Package Settings → SublimeLinter → Settings，在右侧面板（用户设置）中添加：{"paths": {"linux": [],"osx": ["/opt/homebrew/bin"],"windows": ["C:/xampp/php"] } }
注意：paths 填的是 php 所在**目录**，不是可执行文件本身；Windows 用正斜杠或双反斜杠都行
改完保存后，必须重启 Sublime 才生效，仅重载配置无效
如果用了 Docker 或远程 PHP 环境，SublimeLinter 无法直接调用，得换用 phpcs + phpcbf 等本地 CLI 工具链