在我们的日常开发中，尤其是多人协作的项目，代码质量的参差不齐常常让人头疼。想象一下这样的场景：你刚完成了一个新功能，准备提交代码。突然，同事告诉你，他拉取了你的最新代码后，单元测试跑不通了，或者代码风格检查报告了一堆错误。这不仅打断了工作流，还增加了沟通成本和返工时间。
我们团队也曾深受其害。一开始，我们尝试通过口头约定和代码审查来规范代码，但效果不尽如人意。总有人会忘记在提交前运行
php-cs-fixer或
phpstan，导致不符合规范的代码流入主分支。我们知道 Git Hooks 是个好东西，可以在代码提交前自动执行检查，但手动在每个开发者的机器上配置
.git/hooks目录下的脚本，不仅繁琐，而且难以保持同步和更新。一旦有新的检查规则或工具，就需要通知所有成员手动更新，这几乎是不可能完成的任务。
正当我们为如何统一团队的代码质量而苦恼时，我偶然发现了 CaptainHook 这个 PHP Git Hook 管理器，以及它通过 Composer 安装的 PHAR 包
captainhook/captainhook-phar。它简直是为我们量身定制的解决方案！
Composer 登场：轻松管理 CaptainHook
captainhook/captainhook-phar的核心优势在于，它利用 Composer 简化了 CaptainHook 本身的安装和管理。这意味着，我们不再需要手动下载 PHAR 文件，也不用担心版本更新的问题。
安装 CaptainHook 变得异常简单，只需在项目根目录下运行：
composer require --dev captainhook/captainhook-phar
这条命令会把 CaptainHook 的 PHAR 可执行文件下载到
vendor/bin目录下。最棒的是，每次你运行
composer update时，Composer 都会自动检查并更新 CaptainHook 到最新版本。这意味着，团队中的每个成员都能始终使用相同且最新的 Git Hook 配置，极大地减少了维护成本。
如何使用 CaptainHook 解决问题？
安装完成后，CaptainHook 需要一个配置文件来定义你的 Git Hooks。通常，这个文件是
captainhook.json，你可以通过运行
vendor/bin/captainhook install来生成一个基础配置。这个配置文件是项目的一部分，可以随代码一同提交到版本控制系统。
在
captainhook.json中，你可以定义各种 Git 事件（如
pre-commit、
pre-push、
post-merge等）触发时要执行的动作。这些动作可以是 PHP 脚本，也可以是任意的 shell 命令。
举个例子，我们可以配置一个
pre-commitHook，确保每次提交前都运行
php-cs-fixer来格式化代码，并运行
phpstan进行静态分析：
{
"commit-msg": {
"enabled": true,
"actions": [
{
"action": "php vendor/bin/captainhook commit-msg"
}
]
},
"pre-commit": {
"enabled": true,
"actions": [
{
"action": "vendor/bin/php-cs-fixer fix --dry-run --stop-on-violation --diff",
"options": [],
"description": "Checking code style"
},
{
"action": "vendor/bin/phpstan analyse -l 5 src/",
"options": [],
"description": "Running static analysis"
}
]
},
"pre-push": {
"enabled": true,
"actions": [
{
"action": "vendor/bin/phpunit",
"options": [],
"description": "Running unit tests"
}
]
}
}有了这样的配置，每当开发者尝试
git commit时，CaptainHook 就会自动执行
php-cs-fixer和
phpstan。如果这些工具报告了任何错误或不符合规范的地方，提交操作就会被阻止，并提示开发者修复问题。只有当所有检查都通过后，代码才能成功提交。同样，
pre-pushHook 可以确保在代码推送到远程仓库前，所有单元测试都已通过。
CaptainHook 带来的优势和实际效果
引入 CaptainHook 后，我们团队的开发效率和代码质量得到了显著提升：
- 自动化质量保障：不再需要人工提醒或记忆，代码格式化、静态分析和单元测试在提交/推送前自动执行。
- 强制性规范统一：Git Hooks 强制执行预设的编码标准和质量检查。不符合规范的代码根本无法进入版本库，从源头杜绝了质量问题。
- 减少技术债务：问题在最早的阶段（开发者本地）就被发现并解决，避免了问题累积，大大降低了后期修复的成本。
- 提升团队协作效率：开发者可以专注于业务逻辑，无需担心代码质量问题会影响他人。团队成员之间的代码风格和质量保持高度一致。
-
简化的工具链管理：通过 Composer 管理
captainhook/captainhook-phar
，确保了所有开发者使用的 CaptainHook 版本一致，且更新过程无缝透明。
现在，我们团队的 Git 提交历史变得干净整洁，代码库的质量也得到了持续的保障。CaptainHook 结合 Composer，为我们构建了一个强大、自动化且易于维护的代码质量门禁系统。如果你也在为团队代码质量一致性而烦恼，强烈推荐你尝试一下 CaptainHook！它绝对会是你的得力助手。
