如何规范团队的Git提交？Composer结合Husky实现代码提交前校验-composer-PHP中文网

composer 本身不参与 git 提交规范，husky 是 node.js 工具，在 php 项目中无法运行；php 项目应使用 git 原生钩子（如 pre-commit）调用 php-cs-fixer 等 php cli 工具进行校验。

如何规范团队的git提交？composer结合husky实现代码提交前校验

Composer 不参与 Git 提交规范 —— 这是个常见误解。你看到的「Composer + Husky」组合，大概率是混淆了前端与 PHP 生态的工具链。Husky 是 Node.js 生态的 Git Hook 工具，只在 npm/yarn 项目中生效；而 Composer 是 PHP 的依赖管理器，本身不提供钩子机制，也不能直接拦截 git commit。

如果你的项目是 PHP（比如 Laravel、Symfony），想做提交前校验，得换一套方案。

`Husky` 在 PHP 项目里根本跑不起来

Husky 的安装依赖 npm 或 yarn，会往 .git/hooks/ 写 shell 脚本，并通过 node 执行；
PHP 项目没 package.json，也没 node_modules，husky install 会直接失败；
即使硬塞一个 package.json 进去，也违背工程一致性 —— 开发者要同时维护两套依赖和脚本环境，容易出错且难以交接。

常见的错误现象：

执行 git commit 无任何校验，husky 钩子静默失效；
git hooks 目录下没生成 pre-commit 文件，或生成了但权限不对（Windows 上尤其常见）；
控制台报错 sh: husky: command not found 或 Cannot find module 'husky'。

PHP 项目该用什么替代 `Husky`？

真正可行的方案是用 Git 原生钩子 + PHP CLI 工具：

pre-commit 钩子用 shell 脚本写，调用 phpstan、psalm、phpcs 或 php-cs-fixer；
不依赖 Node，所有校验命令都走 php 可执行文件；
配置统一放在项目根目录，例如 .git/hooks/pre-commit（需 chmod +x）；

示例钩子内容（简化版）：

Convert Github Repository

适用于以下场景：（1）用户提供 GitHub 仓库 URL 或本地仓库路径，并请求将其转换为其他格式；（2）用户请求导出 GitHub 仓库……

下载

#!/bin/sh
echo "Running PHP code style check..."
if ! vendor/bin/php-cs-fixer fix --dry-run --using-cache=no; then
  echo "❌ Code style check failed. Please run 'vendor/bin/php-cs-fixer fix' and commit again."
  exit 1
fi

注意点：

php-cs-fixer 必须已通过 composer require --dev friendsofphp/php-cs-fixer 安装；
钩子脚本必须有可执行权限：chmod +x .git/hooks/pre-commit；
团队成员需手动复制或用脚本初始化钩子，无法像 Husky 那样自动注册（这点最容易被忽略）。

为什么不能用 `commitizen` + `commitlint` 管 PHP 提交？

可以，但得绕开 Husky：

commitizen 是命令行工具，只要本地装了 npm 就能运行 git cz，和语言无关；
但 commitlint 校验必须挂到 commit-msg 钩子上 —— PHP 项目没 Husky，就得自己写一个 .git/hooks/commit-msg 脚本，再调用 npx commitlint --edit $1；
这意味着每个开发者都要装 Node，并确保 npx 可用，实际落地成本高，易出兼容问题（比如 Windows 下路径空格、PowerShell 编码乱码导致 commitlint.config.js 读取失败）。