通过集成PHP-CS-Fixer到Composer脚本和Git钩子,可自动修复代码规范问题。1. 安装PHP-CS-Fixer并配置规则文件;2. 在composer.json中添加post-install-cmd和post-update-cmd脚本;3. 设置Git pre-commit钩子,在提交前自动检查并修复格式问题;4. 推荐团队共享配置文件并统一使用composer fix-cs与check-cs命令,确保编码风格一致,提升协作效率与代码质量。

让 Composer 自动修复项目的编码规范问题,核心在于将代码格式化工具集成到 Composer 的脚本钩子中。通过配置 PHP-CS-Fixer 或 PHP_CodeSniffer 等工具,并绑定到 Composer 命令执行前后,可以实现自动化修复。
安装并配置 PHP-CS-Fixer
PHP-CS-Fixer 是最常用的 PHP 编码规范修复工具,能自动修正大多数 PSR 标准相关的问题。
1. 全局或项目内安装:composer require --dev friendsofphp/php-cs-fixer
setRules([
'@PSR12' => true,
'array_syntax' => ['syntax' => 'short'],
'no_unused_imports' => true,
])
->setFinder(
PhpCsFixer\Finder::create()
->in(__DIR__ . '/src')
->in(__DIR__ . '/tests')
);
配置 Composer 脚本自动执行修复
修改 composer.json,添加脚本钩子,在执行某些命令(如 install 或 update)后自动运行修复。
"scripts": {
"post-install-cmd": "php-cs-fixer fix",
"post-update-cmd": "php-cs-fixer fix"
}
这样每次运行 composer install 或 composer update 后,都会自动检查并修复代码风格问题。
设置 Git 钩子实现提交前自动修复(推荐)
更实用的方式是结合 Git 钩子,在代码提交前自动修复,避免把不规范的代码送入仓库。
1. 添加 Composer 脚本:"scripts": {
"post-install-cmd": [
"@composer dump-autoload",
"php-cs-fixer fix --dry-run || true"
],
"check-cs": "php-cs-fixer fix --dry-run --diff",
"fix-cs": "php-cs-fixer fix"
}
2. 安装并配置 composer-scripts 或手动设置 Git hooks
- 使用
cp vendor/bin/php-cs-fixer git-hooks/pre-commit - 在
.git/hooks/pre-commit中加入:
#!/bin/sh vendor/bin/php-cs-fixer fix --dry-run if [ $? -ne 0 ]; then echo "代码格式有问题,请先运行: composer fix-cs" exit 1 fi3. 赋予可执行权限:
chmod +x .git/hooks/pre-commit
日常使用建议
- 开发者可在本地运行
composer fix-cs快速修复所有风格问题 - CI/CD 流程中加入
composer check-cs作为质量门禁 - 团队共享同一份
.php-cs-fixer.php配置,保持统一风格
基本上就这些。通过 Composer 集成 PHP-CS-Fixer,再配合 Git 钩子,就能实现编码规范的自动化管理和修复,减少人工检查成本。不复杂但容易忽略的是配置文件的维护和团队共识。










