如何通过 Composer 管理 PHP 项目的编码规范工具（如 PHP-CS-Fixer）？-composer-PHP中文网

如何通过 Composer 管理 PHP 项目的编码规范工具（如 PHP-CS-Fixer）？

尼克

发布： 2025-12-14 18:45:08

原创

332人浏览过

推荐在项目中用 Composer 安装 PHP-CS-Fixer 作为 dev 依赖，创建 .php-cs-fixer.php 配置规则与扫描范围，通过 vendor/bin/php-cs-fixer fix 自动修复或 --dry-run --diff 预览差异，并集成到 Git 钩子、CI 和 IDE 中。

如何通过 composer 管理 php 项目的编码规范工具（如 php-cs-fixer）？

直接在项目中用 Composer 安装并配置 PHP-CS-Fixer，是最轻量、最可控的方式——它不依赖全局环境，能和项目版本绑定，团队协作时规范一致。

安装 PHP-CS-Fixer 到 dev 依赖

运行以下命令，将 PHP-CS-Fixer 作为开发依赖加入 composer.json：

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

安装后，可执行 vendor/bin/php-cs-fixer --version 验证是否就绪。注意：不要用 --global，避免不同项目间规则冲突。

配置规则文件 `.php-cs-fixer.php`

在项目根目录创建 .php-cs-fixer.php，定义你想启用的编码风格。例如使用 PSR-12 + 少量自定义：

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

返回一个 PhpCsFixer\Config 实例
用 setRules() 指定规则数组，如 ['@PSR12' => true, 'array_syntax' => ['syntax' => 'short']]
用 setFinder() 限定扫描范围，比如只处理 src/ 和 tests/ 下的 .php 文件

配置写好后，工具就知道“修什么”和“在哪修”。