如何使用 Git pre-commit 钩子来自动运行 composer install 或 composer test？

推荐在 pre-commit 钩子中仅执行检查（如验证 composer.lock 一致性、运行测试），不自动执行 composer install；若需自动化，应使用 pre-commit.com 等工具统一管理，避免修改工作区文件。

可以在 git 的 pre-commit 钩子里自动运行 composer install 或 composer test，但需注意：这类操作容易拖慢提交流程、引发意外失败，且不推荐在钩子中修改工作区文件（如 composer install 会写入 vendor/ 和 composer.lock）。更稳妥的做法是用钩子做“检查”而非“修复”。下面分场景说明如何合理实现。

✅ 推荐做法：用 pre-commit 检查依赖和测试是否通过

钩子只负责验证，不自动执行安装或修改文件。若检查失败，中断提交并提示开发者手动处理。

• 确保 composer.lock 与 composer.json 一致：运行 composer validate --no-check-publish && composer check-platform-reqs
• 检查是否有未提交的 composer.lock 变更（即 composer install 应该运行但还没运行）：
  git status --porcelain composer.lock | grep -q '^ M' && echo "Error: composer.lock is modified — run 'composer install' and commit the result" && exit 1 || true
• 运行测试（只读操作，安全）：
  composer test（前提是 composer.json 中已定义 "scripts": {"test": "phpunit ..."} ）

⚠️ 不推荐但可实现：自动运行 composer install

仅适用于团队严格约定“所有提交前必须 vendor 一致”，且能接受钩子修改工作目录（Git 会把新增/修改的 vendor/ 文件纳入暂存区）。

• 在 .git/hooks/pre-commit 中添加：

• #!/bin/sh<br>if ! composer install --no-interaction --quiet; then<br>  echo "composer install failed — aborting commit"<br>  exit 1<br>fi<br># 如果 vendor/ 或 composer.lock 有变更，自动加到本次提交<br>git add vendor/ composer.lock 2>/dev/NULL || true
• 注意：这会让每次提交都带上 vendor/ 变更，可能干扰代码审查；也要求所有开发者本地有 PHP 和 Composer 环境

? 工具化建议：用 husky + lint-staged 或 pre-commit.com

纯 Shell 钩子难维护。推荐用成熟工具统一管理：

Seede AI

AI 驱动的设计工具

713

查看详情

• PHP 项目常用 composer-plugin-pre-commit 或直接用 pre-commit.com（配合 php-hooks）
• 例如用 pre-commit.com 运行测试：
  在 .pre-commit-config.yaml 中写：

  - repo: local<br>  hooks:<br>  - id: phpunit-test<br>    name: Run PHPUnit tests<br>    entry: composer test<br>    language: system<br>    types: [php]
• 这样既可复用，又支持跨平台，还能和 CI 流程对齐

? 关键提醒

不要在 pre-commit 中生成或提交敏感/大体积文件（如完整 vendor/）——这违反 Git 最佳实践。生产环境应由 CI 执行 composer install --no-dev，开发环境建议用 docker 或统一 dev-env 脚本初始化依赖。

基本上就这些。核心是：钩子用来守门，不是用来擦屁股的。

以上就是如何使用 Git pre-commit 钩子来自动运行 composer install 或 composer test？的详细内容，更多请关注php中文网其它相关文章！