CentOS 上 PhpStorm 代码格式化设置
一 内置格式化与快捷键
- 打开设置:依次进入 File → Settings → Editor → Code Style → PHP,可从右上角 Set from… 选择 PSR-12 等内置规范,并按团队要求微调缩进、空格、换行与花括号位置;完成后点击 Apply/OK。
- 快速格式化:在编辑器中按 Ctrl + Alt + L 可格式化当前文件或选中代码块。
- 团队统一:通过 Manage → Import Scheme… 导入团队 XML 风格配置;也可 Export Scheme… 导出供他人使用。
- 不同文件类型:在 Editor → Code Style 中可为 Blade/Twig 等单独建方案并绑定对应语言规则,避免互相影响。
二 使用 PHP-CS-Fixer 统一团队规范
- 安装工具:在项目或全局环境执行
composer global require friendsofphp/php-cs-fixer
确保可执行文件在 PATH(如 ~/.composer/vendor/bin)。
- 在 PhpStorm 配置外部工具:进入 File → Settings → Tools → External Tools → +,新建工具:
- Name: PHP-CS-Fixer
- Program: php
- Arguments: $ProjectFileDir$/.vendor/bin/php-cs-fixer fix $FilePath$ --rules=@PSR12
- Working directory: $ProjectFileDir$
- 创建保存即格式化宏并绑定快捷键:
- Settings → Keymap → + → Macro,录制动作:Run External Tool “PHP-CS-Fixer” → Save All
- 为该宏分配快捷键(如 Ctrl + S),实现保存时自动格式化。
- 说明:也可使用 File Watchers 触发 php-cs-fixer,思路相同,选择“Program/Arguments/Working directory”即可。
三 使用 PHP_CodeSniffer 做规范检查
- 安装:执行
sudo pear install PHP_CodeSniffer
- 在 PhpStorm 配置:进入 File → Settings → Languages & Frameworks → PHP → Code Sniffer,在 Standard 选择 PSR2 或 Symfony 等规范;保存后在编辑器中可用“Code Inspection/Reformat”配合检查与修复。
四 常见问题与排查
- 快捷键无效或被占用:在 Settings → Keymap 搜索 Reformat Code,为 Ctrl + Alt + L 重新绑定;若被系统快捷键占用,可改为 Ctrl + Alt + Shift + L。
- 外部工具找不到:确认 php-cs-fixer 或 phpcs 在 PATH;在 External Tools/File Watchers 中使用绝对路径(如 $ProjectFileDir$/.vendor/bin/php-cs-fixer)。
- 行尾与缩进不一致:在 Editor → Code Style → PHP → Tabs and Indents 设置 Tab size/Indent/Continuation indent(常见为 4),并统一 Line separator(推荐 LF);在 Spaces/Wrapping and Braces 细化空格与换行策略。
- 团队风格不一致:统一使用 PSR-12 或导入团队 XML 方案,并在仓库根目录提供 .php-cs-fixer.dist.php 或 phpcs.xml 以便本地与 CI 一致。