通过Composer脚本自动化部署Git Hooks，可在post-install-cmd和post-update-cmd事件中执行安装脚本，将自定义钩子链接到.git/hooks目录，实现团队统一的代码检查流程，提升开发一致性。
在PHP项目中，Composer不仅用于依赖管理，还能通过scripts功能自动化执行git hooks。这种方式能确保团队成员无需手动配置本地钩子，提升开发流程一致性。
理解Composer Scripts与Git Hooks的结合原理
Composer支持在composer.json中定义脚本，这些脚本可在特定事件触发时自动运行。利用post-install-cmd和post-update-cmd等事件，可以自动将自定义脚本链接到.git/hooks目录下，替代默认的空钩子文件。
核心思路是：将git hook逻辑写成一个可执行脚本，再通过Composer在安装或更新依赖后自动部署到项目的git hooks目录。
配置composer.json实现自动部署hook
在composer.json中添加scripts配置：
- post-install-cmd 和 post-update-cmd：用于在依赖安装或更新后触发hook部署
- 指定执行的命令，例如复制或创建符号链接
示例配置：
"scripts": {
"post-install-cmd": [
"chmod +x ./scripts/git-hooks/install-hooks.sh",
"./scripts/git-hooks/install-hooks.sh"
],
"post-update-cmd": [
"./scripts/git-hooks/install-hooks.sh"
]
}
这样每次运行composer install或update时，都会执行安装脚本。
编写git hooks安装脚本
创建./scripts/git-hooks/install-hooks.sh，内容如下：
#!/bin/bash HOOKS_DIR=".git/hooks" SOURCE_DIR="./scripts/git-hooks" ln -sf "$SOURCE_DIR/pre-commit" "$HOOKS_DIR/pre-commit" ln -sf "$SOURCE_DIR/commit-msg" "$HOOKS_DIR/commit-msg" echo "Git hooks installed."
同时创建具体的hook脚本，如pre-commit，用于执行代码检查：
#!/bin/bash echo "Running PHP lint..." php -l $(git diff --cached --name-only --diff-filter=ACM | grep '\.php$') if [ $? -ne 0 ]; then echo "PHP syntax check failed."; exit 1; fi vendor/bin/phpcs --standard=PSR12 src/ if [ $? -ne 0 ]; then echo "Code style check failed."; exit 1; fi exit 0
确保所有脚本有可执行权限：chmod +x ./scripts/git-hooks/*.sh
注意事项与最佳实践
这类自动化方案虽方便，但也需注意几点：
- 避免将敏感逻辑直接写入脚本，防止被绕过
- 团队成员首次克隆项目后必须运行composer install才能激活hooks
- 考虑使用husky类工具的思路，但用Composer实现更贴近PHP生态
- 可通过环境变量控制是否启用本地hook，便于调试
基本上就这些。只要脚本路径正确、权限设置妥当，Composer就能帮你把git hooks变成项目标准流程的一部分。
