怎样自动触发测试或代码规范检查？配置Composer的scripts脚本-composer-PHP中文网

composer scripts不能替代makefile或npm script，仅适合php项目内部轻量级自动化；它不支持条件判断、循环或跨平台路径处理，应避免数据库迁移、部署等复杂逻辑，只封装纯php命令或可移植cli工具。

怎样自动触发测试或代码规范检查？配置composer的scripts脚本

Composer scripts 能不能替代 Makefile 或 npm script？

能，但只适合 PHP 项目内部轻量级自动化——它不是通用任务调度器，不支持条件判断、循环或跨平台路径处理。如果你的 CI/CD 流水线里已经用 GitHub Actions 或 GitLab CI，composer scripts 最好只做本地开发辅助，比如保存即检查。

常见误用是把数据库迁移、部署逻辑也塞进去，结果在不同环境（Mac/Linux/Windows）下因 shell 解析差异失败。

只放纯 PHP 命令或明确可移植的 CLI 工具调用，比如 phpstan、phpcs、phpunit
避免直接写 sh -c "..." 或管道 |、重定向 >，Windows 的 cmd.exe 不认这些
多命令串联用 && 安全，它会在前一个命令失败时中止，比 ; 更符合“检查失败就停”的预期

怎么写一个带参数的 scripts 命令？

Composer 本身不解析脚本参数，所谓“传参”其实是靠 $@ 透传给底层命令。你得在 composer.json 里用双引号包裹，并显式写出 $@ 占位符。

例如想让 composer test 支持传 PHPUnit 参数：

"scripts": {
  "test": "phpunit --colors=always $@"
}

然后运行 composer test -- --filter=testLogin（注意两个 --：第一个分隔 composer 和脚本，第二个分隔脚本和 phpunit 自己的参数）。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

Windows 用户需改用 %1 %2 替代 $@，但更推荐统一用 cross-env 或直接写成独立 PHP 封装脚本
$@ 在未传参时为空，不会报错；但若底层命令（如 phpcs）要求必选参数，脚本仍会失败
别在 scripts 里硬编码路径，比如 vendor/bin/phpcs —— 应该用 phpcs，确保 PATH 包含 vendor/bin

如何让 git commit 自动触发 phpcs + phpunit？

靠 Composer scripts 搭配 composer install 自动生成的 vendor/bin/composer 不行，得用 Git hooks。最简单是用 composer require --dev phpro/grumphp，它会自动注册 pre-commit hook 并接管检查流程。

如果不想引入新工具，手动配 .git/hooks/pre-commit 文件（需 chmod +x）：

#!/bin/sh
composer run-script check || exit 1

再在 composer.json 定义：

"scripts": {
  "check": [
    "@cs",
    "@test"
  ],
  "cs": "phpcs --standard=PSR12 src/",
  "test": "phpunit --no-coverage"
}

Git hook 脚本必须用 #!/bin/sh，别用 #!/usr/bin/env bash，部分 Linux 发行版默认没装 bash
composer run-script 默认不继承当前 shell 的 PATH，确保 phpcs、phpunit 在系统 PATH 或 vendor/bin 下可用
CI 环境里不要依赖 pre-commit，它只在本地生效；CI 应该单独跑 composer test，和 commit hook 解耦