Composer如何与Git的post-checkout钩子联动实现自动安装-composer-PHP中文网

Composer如何与Git的post-checkout钩子联动实现自动安装

裘德小鎮的故事

发布： 2025-10-09 09:49:01

原创

929人浏览过

通过 Git 的 post-checkout 钩子，在切换分支后自动检测 composer.lock 变更并执行 composer install，确保依赖同步。该脚本仅在分支切换时运行，检查文件变更且存在 composer.json 时触发安装，避免手动遗漏。需团队成员本地配置钩子并统一管理，提升协作效率，减少环境不一致问题。

composer如何与git的post-checkout钩子联动实现自动安装

在使用 Git 和 Composer 协同开发 PHP 项目时，经常会遇到切换分支或更新代码后依赖发生变化的情况。如果其他开发者修改了 composer.json 或 composer.lock 文件，当前环境可能缺少必要的依赖。为避免手动运行 composer install 的疏漏，可以通过 Git 的 post-checkout 钩子自动触发 Composer 安装流程。

什么是 post-checkout 钩子？

Git 提供了多种钩子（hook）机制，post-checkout 是其中之一，它在每次执行 git checkout 或 git switch 成功后自动运行。该钩子可以用来检测代码变更，并执行诸如清理缓存、重建依赖等自动化任务。

实现自动安装的思路

目标是：当 composer.lock 文件在切换分支后发生变化时，自动运行 composer install 来同步依赖。关键在于判断文件是否真正变更，避免无意义重复安装。

通过钩子获取上一个提交和当前提交的差异
检查 composer.lock 是否在变更列表中
若存在变更且当前目录有 composer.json，则执行 composer install

配置 post-checkout 钩子脚本

在项目根目录下创建或编辑 .git/hooks/post-checkout 文件：

#!/bin/sh
# .git/hooks/post-checkout
<h1>参数说明：</h1><h1>$1: 上一个 HEAD 的 SHA-1</h1><h1>$2: 新的 HEAD 的 SHA-1</h1><h1>$3: 是否是分支检出（1 表示是）</h1><p>IS_BRANCH_CHECKOUT=""</p>
                    <div class="aritcle_card">
                        <a class="aritcle_card_img" href="/ai/1909">
                            <img src="https://img.php.cn/upload/ai_manual/001/246/273/68b6d6814117b182.png" alt="寻鲸AI">
                        </a>
                        <div class="aritcle_card_info">
                            <a href="/ai/1909">寻鲸AI</a>
                            <p>寻鲸AI是一款功能强大的人工智能写作工具，支持对话提问、内置多场景写作模板如写作辅助类、营销推广类等，更能一键写作各类策划方案。</p>
                            <div class="">
                                <img src="/static/images/card_xiazai.png" alt="寻鲸AI">
                                <span>68</span>
                            </div>
                        </div>
                        <a href="/ai/1909" class="aritcle_card_btn">
                            <span>查看详情</span>
                            <img src="/static/images/cardxiayige-3.png" alt="寻鲸AI">
                        </a>
                    </div>
                <h1>只在切换分支时执行（避免 git pull 触发）</h1><p>if [ "$IS_BRANCH_CHECKOUT" != "1" ]; then
exit 0
fi</p><h1>检查是否存在 composer.lock 文件</h1><p>if [ ! -f composer.lock ]; then
exit 0
fi</p><h1>检查 composer.lock 是否在本次变更中被修改</h1><p>if git diff --name-only "$1" "$2" | grep -qE '^composer.lock$'; then
if [ -f composer.json ]; then
echo "Detected change in composer.lock, running composer install..."
composer install --no-interaction
fi
fi</p>

登录后复制

保存后，赋予可执行权限：