php-git-hooks可解决PHP 8.1项目中pre-commit钩子的同步、性能与兼容性问题：通过Composer安装自动生成php-git-hooks.yml配置文件，限定仅校验暂存区PHP文件，禁用冗余工具链，明确分工phpcs（报错）、php-cs-fixer（修复）、PHPStan（类型检查），适配PHP 8.1属性语法且不干扰IDE自动格式化。
PHP 8.1 项目中落地 Git 钩子自动校验代码规范，关键不在“能不能写”，而在“谁来执行、何时执行、怎么不打架”。重点是让 pre-commit 真正生效、可共享、不卡顿、不误拦，同时适配 PHP 8.1 的工具链特性（如属性钩子不影响校验逻辑，但需确保静态分析工具兼容）。
用 php-git-hooks 统一管理，避免手动写 .git/hooks
直接往 .git/hooks/pre-commit 里塞 Shell 脚本看似简单，但无法随仓库同步——队友克隆后钩子就失效。php-git-hooks 通过 Composer 安装 + 配置文件驱动，解决同步问题：
- 运行
composer require bruli/php-git-hooks --dev，安装后自动触发交互式配置向导 - 生成
php-git-hooks.yml，所有规则集中维护，提交即共享 - 支持 PHP 8.1+，对属性钩子（
#[Attribute]）无干扰，静态分析工具能正常识别语法结构
pre-commit 只检查暂存区 PHP 文件，不扫全量
校验范围必须精准限定，否则每次提交都跑整个 src/，既慢又容易因忽略规则（如 vendor/ 或 storage/）报错中断：
Pilot Digital Twin Setup
下载
部署一个包含 4 个智能体（agent）的数字孪生平台。在以下情况下使用该技能： 1. 用户希望为物理资产监控与预测性维护等场景搭建数字孪生系统……
- 在
php-git-hooks.yml中启用pre-commit，并明确指定文件匹配模式：php_files: "**/*.php" - 禁用对模板、迁移、测试文件的检查（除非你真需要），例如：
ignore: ["tests/**", "database/migrations/**", "resources/views/**"] - 避免同时启用 phpcs + php-cs-fixer + phpcbf —— PHP-CS-Fixer 已覆盖格式修复，phpcbf 再介入会导致规则冲突和重复 diff
分角色使用工具：查归查，改归改，类型归类型
PHP 8.1 生态下，工具职责必须清晰，否则本地保存一次、提交一次、CI 跑一次，结果三套输出互相覆盖：
立即学习“PHP免费学习笔记（深入）”；
-
风格检查（只报错）：用
phpcs，配置标准如PSR-12或自定义规则集，放在 CI 中作为最终门禁 -
风格修复（自动改）：用
php-cs-fixer，集成进 pre-commit 钩子，本地提交前自动修正缩进、短数组、strict_types 等 -
类型与逻辑检查：用
PHPStan（level 6+ 支持 PHP 8.1 属性钩子推导），放在 pre-push 或 CI，不放进 pre-commit（太重）
配合 git add -p 和 IDE 自动格式化，降低开发者阻力
钩子不是用来惩罚开发者的，而是减少低级错误。要让它被长期坚持，就得减少手动干预：
- 在
php-cs-fixer.php配置中开启->setRules(['@PSR12' => true, 'array_syntax' => ['syntax' => 'short']])，与主流 IDE（PhpStorm / VS Code + PHP Intelephense）默认格式一致 - 鼓励用
git add -p按块暂存，避免把未修改的文件也带进校验范围 - 在
php-git-hooks.yml的message区块设置友好提示，比如error-message: "PHP 格式有误，请先运行 php-cs-fixer fix 或保存时自动格式化"
