Composer怎么配合GrumPHP代码检查_Composer GrumPHP集成方式【详解】-composer-PHP中文网

grumphp安装后需四者对齐才能触发检查：composer源同步、php≥7.4、git:init初始化钩子、grumphp.yml配置正确；报“could not find package”主因是国内镜像未同步，应切官方源并确认php版本与--dev参数。

composer怎么配合grumphp代码检查_composer grumphp集成方式【详解】

GrumPHP 不是装完就能用的“开箱即用”工具，它依赖 Composer 的安装路径、PHP 版本、Git 钩子注册状态和配置文件位置四者严格对齐；任一环节错位，git commit 就不会触发检查。

composer require --dev phpro/grumphp 为什么报 Could not find package

最常见原因是 Composer 源未同步最新包，尤其国内镜像（如阿里云）存在数小时延迟，而 phpro/grumphp 4.x 起已要求 PHP ≥ 7.4 且依赖新版 Symfony 组件，旧镜像常缺这些包。

临时切回官方源再试：composer config -g repo.packagist composer https://packagist.org
确认 PHP 版本：php -v，必须 ≥ 7.4（推荐 8.0+）
--dev 参数不可省略——GrumPHP 是开发期工具，不是运行时依赖
装完别跳过初始化：vendor/bin/grumphp git:init，否则 .git/hooks/pre-commit 不会生成

git commit 不触发 grumphp：hook 文件存在但不执行

Hook 存在 ≠ 能执行。Linux/macOS 下权限不对、Windows 下 Git Bash 环境变量缺失、或提交时加了 -n / --no-verify 都会导致静默跳过。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

检查 hook 是否可执行：ls -l .git/hooks/pre-commit，输出中应含 x（如 -rwxr-xr-x）
若不可执行，手动修复：chmod +x .git/hooks/pre-commit
Windows 用户建议用 WSL 或 PowerShell 执行 vendor/bin/grumphp git:init，Git Bash 常因 $PATH 缺失 php 而失败
日常提交务必用 git commit -m "xxx"，避免任何绕过 flag

grumphp.yml 配置写对了，task 却提示 “is not registered”

GrumPHP 本身不带任何检查能力，每个 task（如 phpcs、phpstan）都需单独安装对应 Composer 包，并在配置中显式启用——漏装、拼错名、缩进错层都会导致任务注册失败。

先装工具：composer require --dev squizlabs/php_codesniffer（对应 phpcs task）
配置文件必须叫 grumphp.yml（不是 .yml 或 grumphp.yaml），且放在项目根目录
顶层键必须是 grumphp:（冒号不能少），tasks: 必须缩进对齐，task 名全小写、无空格、无下划线（如 phpcs，不是 PHP_CodeSniffer）

示例有效片段：

grumphp:
  tasks:
    phpcs:
      standard: PSR12
      triggered_by: ['php']

非标准项目结构下 grumphp run 报错 “Cannot find composer.json”

GrumPHP 默认从当前工作目录向上查找 composer.json，若你的 composer.json 在 backend/ 子目录，或项目根目录不含该文件，就会失败。

启动时显式指定配置路径：php ./vendor/bin/grumphp run --config=backend/grumphp.yml
或设环境变量（CI 场景更稳）：GRUMPHP_COMPOSER_DIR=backend php ./vendor/bin/grumphp run

也可在 composer.json 的 extra.grumphp 中硬编码路径：

"extra": {
  "grumphp": {
    "config-default-path": "backend/grumphp.yml",
    "project-path": "backend"
  }
}

真正卡住人的往往不是某一步不会做，而是多个路径变量（GRUMPHP_COMPOSER_DIR、GRUMPHP_PROJECT_DIR、grumphp.yml 位置、Git 工作目录）之间互相影响，改一个就得全盘验证——建议每次只动一个变量，用 vendor/bin/grumphp -v run 看实际加载的路径和配置。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！