PHP-CS-Fixer – 自动修复 PHP 代码风格，让代码规范一键到位-壹联网络

PHP-CS-Fixer（PHP Coding Standards Fixer）是一款自动修复 PHP 代码风格问题的工具，由社区主导开发，旨在帮助 PHP 开发者自动将代码规范化为符合 PSR-12、Symfony 等主流编码规范的标准。它能够自动修复数百种代码风格问题，从缩进、空格、换行到复杂的语言结构规范，无需人工逐条修改，极大提升了代码审查的效率。

PHP-CS-Fixer 在 GitHub 上拥有超过 13,000 颗星，是 PHP 开发者工具链中不可或缺的自动化工具。通过在代码提交前自动格式化，它彻底消除了团队内部因代码风格不一致而产生的无意义讨论，让 Code Review 聚焦于业务逻辑而非格式之争。

■ 为什么需要 PHP-CS-Fixer？

在团队协作开发中，代码风格不一致是最常见也最令人头疼的问题。不同开发者使用不同的 IDE 设置、有的人用 Tab、有的人用空格、有的人函数括号不换行——这些差异会导致 Git Diff 噪声极大，Code Review 效率低下，更影响代码的可维护性。

PHP-CS-Fixer 的解决方案是：将代码风格规则代码化，通过工具强制执行，人工只需运行一条命令，所有风格问题一扫光。

■ 核心特色

1. 修复规则超过 300 条
覆盖 PHP-Coding-Standards（基础规范）、Symfony（更严格规范）、PSR-12（PHP 官方推荐）等多套规则集。

2. 精确修复 + 智能安全
内置安全修复机制，工具会分析代码抽象语法树（AST），避免破坏代码逻辑的「误修复」。对于可能存在风险的修复，会给出警告提示。

3. Dry Run 模式
默认先以 Dry Run 模式展示将要修改的内容，不实际改动文件，确认无误后再执行真正的修复。

4. 缓存机制
内置文件级缓存，重复运行时光分析未变化的文件，大幅加速 CI 中的检查速度。

5. 多种输出格式
支持 JSON、XML、JUnit、HTML 等多种输出格式，完美集成 Jenkins、GitLab CI、GitHub Actions 等CI工具。

6. 完全自动化工作流
支持 git hook（pre-commit）集成，代码提交前自动修复，开发者无需记忆任何命令。

■ 安装步骤

方式一：Composer 局部安装（推荐项目内使用）

composer require --dev friendsofphp/php-cs-fixer

方式二：全局安装

composer global require friendsofphp/php-cs-fixer
# 确保 ~/.composer/vendor/bin 在 PATH 中

方式三：无需 PHP 环境（phar 下载）

wget https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/releases/download/v3.65.0/php-cs-fixer.phar -O php-cs-fixer
chmod +x php-cs-fixer
./php-cs-fixer --version

■ 基础使用

修复单个文件：

php-cs-fixer fix /path/to/file.php

修复整个目录：

php-cs-fixer fix /path/to/project/src --rules=@Symfony

Dry Run（仅预览，不修改）：

php-cs-fixer fix /path/to/project/src --dry-run --diff

使用特定规则集：

# 使用 PSR-12 规范
php-cs-fixer fix /path/to/file.php --rules='@PSR12'

# 使用 Symfony 规范
php-cs-fixer fix /path/to/file.php --rules='@Symfony'

■ 配置文件（.php-cs-fixer.php 或 .php-cs-fixer.dist.php）

<?php
return (new PhpCsFixer\Config())
    ->setRules([
        '@PSR12' => true,
        'array_syntax' => ['syntax' => 'short'],
        'binary_operator_spaces' => true,
        'not_operator_with_successor_space' => true,
    ])
    ->setFinder(
        PhpCsFixer\Finder::create()
            ->exclude('vendor')
            ->in(__DIR__)
    );

■ Git Hook 集成（pre-commit）

使用 Composer 脚本自动安装 Git Hook：

{
    "scripts": {
        "cs-fix": "php-cs-fixer fix --config=.php-cs-fixer.php",
        "cs-check": "php-cs-fixer fix --config=.php-cs-fixer.php --dry-run --diff"
    },
    "scripts": {
        "post-install-cmd": [
            "@php-cs-fixer install --ansi"
        ],
        "post-update-cmd": [
            "@php-cs-fixer install --ansi"
        ]
    }
}