首先确保系统安装PHP和PHP CS Fixer,通过Composer全局安装php-cs-fixer并加入PATH;接着在Sublime Text中创建自定义构建系统,配置命令调用php-cs-fixer格式化当前文件;然后设置快捷键Ctrl+Shift+F(或Cmd+Shift+F)快速触发格式化;最后可在项目根目录添加.php-cs-fixer配置文件以定义PSR12等统一代码风格规则。

要在 Sublime Text 中配置 PHP CS Fixer 实现 PHP 代码自动格式化,需要安装并设置相关插件,确保系统中已正确安装 PHP 和 PHP CS Fixer。以下是具体步骤:
1. 安装 PHP CS Fixer
确保你的系统可以运行 PHP CS Fixer,可以通过 Composer 全局安装: 如果提示命令未找到,请将 Composer 的全局 bin 目录加入系统 PATH(如 Linux/macOS 通常是 ~/.composer/vendor/bin,Windows 是 %APPDATA%\Composer\vendor\bin)。2. 安装 Sublime 插件
推荐使用 SublimeLinter-phpcs 或 External Tools 方式调用 php-cs-fixer,但更直接的方式是使用 PhpFormatter 或自定义构建系统。这里以创建自定义构建系统为例,灵活且无需额外插件:
- 在 Sublime Text 中点击菜单栏:Tools → Build System → New Build System…
- 将以下内容粘贴进去:
{
"cmd": ["php-cs-fixer", "fix", "$file"],
"selector": "source.php",
"shell": true,
"working_dir": "$file_path",
"encoding": "utf-8",
"quiet": false
}- 保存文件为:PHP-CS-Fixer.sublime-build
3. 设置快捷键自动格式化
为了方便使用,可绑定快捷键触发格式化:- 点击菜单:Preferences → Key Bindings
- 在右侧用户键位绑定中添加:
{
"keys": ["ctrl+shift+f"],
"command": "build",
"context": [
{ "key": "selector", "operator": "equal", "operand": "source.php" }
]
}这样,当你打开一个 PHP 文件并按下 Ctrl+Shift+F(Mac 上可用 Cmd+Shift+F),就会自动运行 php-cs-fixer 格式化当前文件。
4. 可选:使用 .php-cs-fixer 配置文件
在项目根目录添加 .php-cs-fixer 文件,自定义修复规则:- 例如创建 .php-cs-fixer.dist 文件:
setRules([
'@PSR12' => true,
'array_syntax' => ['syntax' => 'short'],
'ordered_imports' => true,
])
->setFinder(
PhpCsFixer\Finder::create()
->in(__DIR__ . '/src')
->in(__DIR__ . '/tests')
);这样格式化时会按项目规则执行,适合团队统一代码风格。
立即学习“PHP免费学习笔记(深入)”;
基本上就这些。配置完成后,每次写完 PHP 代码按下快捷键即可自动格式化,提升编码效率和一致性。注意确保命令行能直接运行 php-cs-fixer,否则构建会失败。不复杂但容易忽略环境路径问题。











