centos上phpstorm代码格式化设置

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 一致。