配置sublime Text使用php-cs-fixer实现PHP代码格式化:1. 通过composer安装php-cs-fixer并确认路径;2. 在Sublime中安装EasyPHP-CS-Fixer插件;3. 配置插件中的php_cs_fixer_path和php_path路径;4. 可选设置快捷键Ctrl+Alt+F用于快速格式化;5. 在项目根目录创建.php-cs-fixer.dist文件自定义代码风格规则。完成后可通过手动触发或保存时自动格式化代码,提升开发效率与团队编码规范一致性。

sublime text 配置 PHP 代码格式化(使用 php-cs-fixer)可以让开发更高效、代码风格更统一。下面介绍完整配置方法,确保你能在 Sublime 中一键格式化 PHP 代码。
1. 安装 php-cs-fixer
确保系统中已安装 php-cs-fixer,可通过 Composer 全局安装:
- 打开终端(命令行)
- 运行命令:
composer global require friendsofphp/php-cs-fixer - 安装完成后,确认可执行文件路径(通常为:
~/.composer/vendor/bin/php-cs-fixer或~/.config/composer/vendor/bin/php-cs-fixer)
windows 用户注意:将该路径加入系统环境变量 PATH,或记住完整路径备用。
2. 安装 Sublime 插件:SublimeAStyleFormatter 或 EasyPHP-CS-Fixer
推荐使用 EasyPHP-CS-Fixer 或通过 Package Control 安装通用格式化插件。
立即学习“PHP免费学习笔记(深入)”;
- 打开 Sublime Text,按下
Ctrl+Shift+P(mac:Cmd+Shift+P) - 输入 “Install Package”,选择对应选项
- 搜索并安装
EasyPHP-CS-Fixer或SublimeAStyleFormatter
这里以 EasyPHP-CS-Fixer 为例,它专为 php-cs-fixer 设计,配置简单。
3. 配置 EasyPHP-CS-Fixer 插件
安装完成后进行路径和规则设置:
- 点击菜单栏:
Preferences > Package Settings > EasyPHP-CS-Fixer > Settings – User - 在配置文件中填入以下内容(根据实际路径修改):
{ "php_cs_fixer_path": "/Users/yourname/.composer/vendor/bin/php-cs-fixer", "php_path": "/usr/bin/php", "on_save": false, "show_output": true }
说明:
-
php_cs_fixer_path:php-cs-fixer 的实际路径,linux/Mac 用上面路径,Windows 可设为:C:UsersYourNameappDataRoamingComposervendorbinphp-cs-fixer.bat -
php_path:PHP 可执行文件路径,可通过which php查看 -
on_save:设为 true 可在保存时自动格式化 -
show_output:调试时建议开启,查看是否出错
4. 设置快捷键(可选)
为快速格式化添加快捷键:
- 打开:
Preferences > Key Bindings - 在右侧用户键位绑定中添加:
[ { "keys": ["ctrl+alt+f"], "command": "easy_php_cs_fixer" } ]
现在按下 Ctrl+Alt+F(Mac 可能用 Cmd+Option+F)即可格式化当前 PHP 文件。
5. 自定义代码风格规则(.php-cs-fixer.dist 文件)
在项目根目录创建 .php-cs-fixer.dist 文件,自定义格式规则:
<?php return PhpCsFixerConfig::create() ->setRules([ '@PSR12' => true, 'array_syntax' => ['syntax' => 'short'], 'ordered_imports' => true, 'no_unused_imports' => true, ]) ->setFinder( PhpCsFixerFinder::create() ->in(__DIR__ . '/src') ->in(__DIR__ . '/tests') );
这样每个项目可以独立控制代码风格。
基本上就这些。配置成功后,每次保存或手动触发就能自动美化 PHP 代码,保持团队编码规范一致。


