如何利用composer scripts实现git hooks自动化？-composer-PHP中文网

如何利用composer scripts实现git hooks自动化？

尼克

发布： 2025-10-31 16:14:02

原创

148人浏览过

通过Composer脚本自动化部署Git Hooks，可在post-install-cmd和post-update-cmd事件中执行安装脚本，将自定义钩子链接到.git/hooks目录，实现团队统一的代码检查流程，提升开发一致性。

如何利用composer scripts实现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时，都会执行安装脚本。

PatentPal专利申请写作

AI软件来为专利申请自动生成内容

查看详情

编写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