PHP-CS-Fixer禁止多行数组末尾逗号的配置方法与步骤

PHP-CS-Fixer 默认会强制要求多行结构末尾添加逗号，但通过调整 trailing_comma_in_multiline 规则的 elements 配置项，传入一个空数组参数，就能精确实现「禁止尾随逗号」的代码规范校验。

PHP-CS-Fixer 本身倾向于默认开启多行尾逗号的强制添加。但如果你希望反其道而行——彻底禁止这些尾随逗号，其实也并不复杂，关键在于如何正确配置这条规则。

这个 trailing_comma_in_multiline 规则并不是一个简单的开关。它的具体行为由 elements 配置项决定。举个例子，如果你指定 'elements' => ['array']，那么规则仅对数组类型生效；而当你传入一个空数组 [] 时，PHP-CS-Fixer 会将其理解为：禁用所有元素类型的尾随逗号。这个逻辑在官方文档中没有明确提及，但在实际项目中相当好用。

✅ 正确配置如下（推荐写入 .php-cs-fixer.php）：

return (new PhpCsFixerConfig())    ->setRules([        'trailing_comma_in_multiline' => ['elements' => []],        // 其他规则...    ])    ->setFinder($finder);

⚠️ 使用时有几个关键点值得注意：

• 该配置仅作用于多行结构，也就是那些换行书写且包含多个元素的数组、函数调用或参数列表。单行数组如 ['a', 'b'] 完全不受影响；
• 必须使用 []（空数组），不能写成 false、null 或干脆省略这个键——否则规则要么被忽略，要么会按照默认逻辑继续允许尾逗号存在；
• 从 PHP-CS-Fixer v3.5+ 开始，这一行为已经稳定支持。较低版本（例如 v2.x）不兼容，请先升级到最新稳定版；
• 执行修复命令时，它会自动删除不合法的尾随逗号。例如将 ['a', 'b',] 转换成 ['a', 'b']，而不仅仅是报一个警告。

总结一下：通过 'trailing_comma_in_multiline' => ['elements' => []] 这样一个简洁的配置，就能让团队统一遵守“多行数组/调用不得包含尾随逗号”的规范，在代码可读性与一致性之间取得很好的平衡。