如何解决PHP代码风格不一致的问题，使用ergebnis/php-cs-fixer-config让代码自动整洁划一-小浪学习网

可以通过一下地址学习composer：学习地址

在php开发中，我们有 friendsofphp/php-cs-fixer 这样的利器，它能帮助我们自动修复代码风格问题。然而，php-cs-fixer 本身提供了大量的规则，如何选择和组合这些规则，使其符合团队的实际需求，并保持与php版本兼容，往往是一个耗时且容易出错的任务。每次新项目启动，或者php版本升级，都可能需要重新审视和调整配置，这无疑增加了维护成本。

遇到的困难：代码风格的“无序之美”

想象一下，一个多人协作的项目，每个开发者都有自己独特的代码风格偏好。有人喜欢紧凑的代码，有人偏爱宽松的格式；有人习惯K&R风格的括号，有人则坚持Allman风格。当这些不同风格的代码汇聚到一起时，项目就会变得像一个“大杂烩”，可读性急剧下降。

代码审查效率低下： 团队成员不得不花费大量时间在代码风格问题上，而不是关注业务逻辑和潜在的bug。
新人上手困难： 新加入的开发者需要额外学习并适应团队的代码规范，这延缓了他们贡献代码的速度。
维护成本增加： 缺乏统一规范的代码库，在后期维护和重构时，开发者需要不断地在不同风格之间切换思维，增加了出错的风险。
“代码洁癖”的痛苦： 对于有“代码洁癖”的开发者来说，看到不规范的代码简直是一种折磨！

虽然 php-cs-fixer 可以解决一部分问题，但要为每个项目手动配置规则集，并确保其与当前PHP版本兼容，依然是一项繁琐的工作。我们需要的，是一个能够提供开箱即用、且与PHP版本高度匹配的标准化规则集。

解决方案：ergebnis/php-cs-fixer-config 的魔力

今天，我要向大家介绍一个强大的工具——ergebnis/php-cs-fixer-config。它不是一个全新的代码格式化工具，而是 friendsofphp/php-cs-fixer 的“最佳拍档”，它提供了一系列预定义的、经过精心设计的规则集，让你无需从零开始配置，就能快速拥有一个专业且一致的代码风格规范。

ergebnis/php-cs-fixer-config 的核心价值在于：

立即学习“PHP免费学习笔记（深入）”；

版本化的规则集： 它为不同PHP版本（从PHP 5.3到最新的PHP 8.4）提供了对应的规则集，确保你的代码风格与目标PHP版本的功能和最佳实践保持一致。
配置工厂： 它提供了一个配置工厂，让你能够以编程的方式构建 php-cs-fixer 的配置，而不是手动编写复杂的数组。
高度可定制： 尽管提供了预设规则，但你仍然可以轻松地覆盖、添加或禁用特定规则，以满足项目的特殊需求。

如何使用 ergebnis/php-cs-fixer-config

首先，我们需要通过 Composer 将其安装到项目中。由于这通常是开发依赖，我们使用 –dev 标志：

composer require --dev ergebnis/php-cs-fixer-config

安装完成后，你需要在项目根目录创建一个名为 .php-cs-fixer.php 的配置文件。这是 php-cs-fixer 读取配置的地方。以下是一个基于 PHP 8.3 规则集的基本配置示例：

<?php  declare(strict_types=1);  use ErgebnisPhpCsFixerConfig;  // 选择适合你项目PHP版本的规则集，例如这里是 PHP 8.3 $ruleSet = ConfigRuleSetPhp83::create();  // 使用配置工厂从规则集创建配置 $config = ConfigFactory::fromRuleSet($ruleSet);  // 配置需要检查和修复的文件范围，这里是当前目录下的所有PHP文件 $config->getFinder()->in(__DIR__);  // 设置缓存文件路径，避免每次都重新分析所有文件，提高效率 $config->setCacheFile(__DIR__ . '/.build/php-cs-fixer/.php-cs-fixer.cache');  return $config;

一点小贴士： 记得将 /.build/ 目录（或你设置的缓存目录）添加到你的 .gitignore 文件中，避免将缓存文件提交到版本控制系统。

# .gitignore +/.build/ /vendor/

进阶用法：定制化你的代码风格

ergebnis/php-cs-fixer-config 提供了极大的灵活性，允许你根据项目需求进行高级定制：

1. 添加文件头部注释（Header Comment）： 如果你希望在每个PHP文件顶部自动添加版权信息或许可证声明，可以这样做：

<?php  declare(strict_types=1);  use ErgebnisPhpCsFixerConfig;  $header = <<<EOF Copyright (c) 2023 你的公司/名字  For the full copyright and license information, please view the LICENSE file that was distributed with this source code.  @see https://your-project-url.com EOF;  $ruleSet = ConfigRuleSetPhp83::create()->withHeader($header);  $config = ConfigFactory::fromRuleSet($ruleSet);  $config->getFinder()->in(__DIR__); $config->setCacheFile(__DIR__ . '/.build/php-cs-fixer/.php-cs-fixer.cache');  return $config;

2. 覆盖或禁用特定规则： 如果预设规则中某个规则不符合你的习惯，你可以轻松地覆盖它。例如，禁用 mb_str_functions 和 strict_comparison 规则：

<?php  declare(strict_types=1);  use ErgebnisPhpCsFixerConfig;  $ruleSet = ConfigRuleSetPhp83::create()->withRules(ConfigRules::fromArray([     'mb_str_functions' => false, // 禁用此规则     'strict_comparison' => false, // 禁用此规则 ]));  $config = ConfigFactory::fromRuleSet($ruleSet);  $config->getFinder()->in(__DIR__); $config->setCacheFile(__DIR__ . '/.build/php-cs-fixer/.php-cs-fixer.cache');  return $config;

3. 集成自定义 Fixer： 对于更高级的需求，如果你有自己编写的 php-cs-fixer 规则，也可以轻松地集成进来：

<?php  declare(strict_types=1);  use ErgebnisPhpCsFixerConfig; use FooBarFixer; // 假设这是你的自定义 Fixer 命名空间  $ruleSet = ConfigRuleSetPhp83::create()     ->withCustomFixers(ConfigFixers::fromFixers(         new FixerMyCustomFixerOne(),         new FixerMyCustomFixerTwo(),     ))     ->withRules(ConfigRules::fromArray([         'FooBar/my_custom_fixer_one' => true,         'FooBar/my_custom_fixer_two' => [             'option' => 'value',         ],     ]));  $config = ConfigFactory::fromRuleSet($ruleSet);  $config->getFinder()->in(__DIR__); $config->setCacheFile(__DIR__ . '/.build/php-cs-fixer/.php-cs-fixer.cache');  return $config;

自动化你的代码风格检查

配置好 .php-cs-fixer.php 文件后，你可以通过多种方式自动化代码风格检查和修复：

Composer 脚本： 在 composer.json 中添加一个脚本，方便团队成员执行：

{   "scripts": {     "coding-standards": [       "mkdir -p .build/php-cs-fixer",       "php-cs-fixer fix --diff --show-progress=dots --verbose"     ]   } }

然后运行 composer coding-standards 即可。

Git Hooks： 配置 pre-commit 或 pre-push 钩子，在提交或推送代码前自动检查。
CI/CD 流水线： 在 github Actions、gitlab CI 或 jenkins 等持续集成服务中添加一个步骤，确保每次代码提交都符合规范。这在团队协作中尤为重要，可以强制执行代码风格，避免不规范的代码进入主分支。