Composer如何使用脚本运行代码检查_Composer脚本运行代码检查技巧-composer-PHP中文网

composer脚本需在composer.json的"scripts"中定义命令，先安装dev-dependency工具（如phpcs、phpstan），再用@php vendor/bin/tool $@传参并确保exit code透传，ci中用composer exec或包装脚本避免默认忽略错误码。

composer如何使用脚本运行代码检查_composer脚本运行代码检查技巧

Composer脚本里怎么调用PHP_CodeSniffer或PHPStan

Composer本身不执行代码检查，它只是帮你把检查工具（比如 phpcs、phpstan、psalm）的命令封装成可复用的脚本。关键在 composer.json 的 "scripts" 段里写对命令，并确保工具已作为 dev-dependency 安装。

常见错误是直接写 "cs": "phpcs" 却没装 phpcodesniffer，结果运行 composer run cs 报错 Command "phpcs" is not defined —— 这说明命令没被识别，不是脚本写错了，而是工具根本没装进 vendor/bin/。

先装工具：composer require --dev squizlabs/php_codesniffer 或 composer require --dev phpstan/phpstan
再定义脚本："scripts": {"cs": "phpcs src/ --standard=PSR12"}
运行时用 composer run cs（Composer 2.4+）或 composer cs（旧版）
如果想跳过 vendor/autoload.php 自动加载（比如检查启动阶段就报错的项目），加 --no-plugins 参数

如何让Composer脚本支持传参（比如指定目录或级别）

Composer原生不解析脚本参数，但可以用 [@php](https://getcomposer.org/doc/articles/scripts.md#event-objects) 占位符 + 环境变量绕过限制。更实用的做法是：用 shell 包一层，把 $@ 透传过去。

例如你想运行 composer run cs -- src/Tests 并让它真正传参给 phpcs，就得在 composer.json 里这样写：

"scripts": {
  "cs": "@php vendor/bin/phpcs --standard=PSR12 $@"
}

注意两点：一是必须用 @php 显式调用 PHP 解释器（避免 Windows 下找不到 .bat/.sh）；二是 $@ 只在 Linux/macOS 有效，Windows 需换用 %*，所以跨平台项目建议改用包装脚本（如 bin/cs）。

Windows 用户若坚持用 JSON 写脚本，得写两套："cs": "@php vendor/bin/phpcs --standard=PSR12 %*"
参数带空格？用引号包裹整个参数段，如 composer run cs -- "src/My Class"
别在脚本里硬编码路径，用 ${PWD} 或 ./ 更安全

为什么脚本执行后退出码总是0，导致CI里检查失败不中断

这是最隐蔽的问题：Composer 默认忽略子命令的退出码。哪怕 phpstan analyse 找出10个错误、返回非0状态，composer run stan 仍显示成功（exit code 0），CI 流程就继续往下走。

Discussion Composer

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

下载

根本原因是 Composer 脚本默认以“事件监听器”方式执行，不继承子进程退出码。解决办法只有一个：显式用 exec 替换默认行为（仅限 shell 脚本）。

Linux/macOS：把脚本改成 "stan": "exec vendor/bin/phpstan analyse src/"
Windows 不支持 exec，只能靠包装批处理（bin/stan.bat）并用 exit /b %errorlevel% 透传
或者统一用 composer exec（Composer 2.5+）：composer exec -- phpstan analyse src/，它会正确传播退出码
CI 中务必加 set -e（bash）或 ExitOnFailure（PowerShell）兜底

多个检查工具串联执行，失败时要立刻停止

用 && 连接命令是最直接的方式，但要注意 Composer 脚本里不能直接写多条命令（JSON 不支持分号或换行）。必须包进 shell -c 或单独抽成脚本文件。

例如想按顺序跑 phpcs → phpstan → tests，任一失败就停，推荐做法是新建 bin/check：

#!/usr/bin/env bash
vendor/bin/phpcs "$@" && \
vendor/bin/phpstan analyse "$@" && \
vendor/bin/phpunit "$@"

然后在 composer.json 里只写 "check": "bin/check"。这样既清晰，又避免 JSON 转义麻烦，还能自由加日志、颜色控制、超时判断等逻辑。

别用 "check": "phpcs && phpstan && phpunit" —— 缺少路径和 vendor/bin 前缀，99% 失败
如果某些检查允许失败（比如 psalm level 5 先跳过），用 || true 显式忽略，别依赖“可能成功”
CI 中建议加 timeout 300s bin/check 防止某项卡死

脚本看似简单，但退出码透传、参数传递、跨平台兼容这三点，几乎每个团队都踩过至少两次坑。