Composer run-script怎么用_Composer运行脚本教程【详解】-composer-PHP中文网

composer run-script 是 composer run 的已弃用别名，应改用 composer run 或直接 composer [script-name]；它不支持新参数且会输出警告。

composer run-script怎么用_composer运行脚本教程【详解】

直接说结论： composer run-script 不是独立命令，它只是 composer run 的别名（从 Composer 2.0 开始），真正执行的是 scripts 段定义的脚本；多数情况下，你应该直接用 composer run 或更简洁的 composer [script-name]。

为什么 `composer run-script` 基本不用了

Composer 2.0 起把 run-script 命令标记为“deprecated”，并重定向到 run。运行 composer run-script build 实际等价于 composer run build，但前者会输出警告：

Deprecated: The "run-script" command is deprecated. Use "run" instead.

不是报错，但 CI/CD 日志里会出现，影响可读性
官方文档已全面替换为 composer run
run-script 不支持 --list、--no-ansi 等新参数

怎么正确运行自定义脚本（`composer.json` 中的 `scripts`）

脚本必须先在 composer.json 的 scripts 字段里声明，例如：

Discussion Composer

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

下载

{
  "scripts": {
    "dev-start": "php -S localhost:8000 -t public",
    "test": ["@php vendor/bin/phpunit", "--colors=always"],
    "build": "npm run build && cp dist/* public/"
  }
}

单行命令直接写字符串；多步骤用数组，按顺序执行
以 @ 开头的命令（如 @php）会递归调用其他脚本，避免 shell 解析歧义
脚本名不能含空格或特殊字符，否则无法通过 composer xxx 直接触发
想传参？用双横线：composer run test -- --filter=MyTest，后面部分透传给脚本进程

`composer run` 和直接 `composer [script-name]` 有啥区别

两者功能一致，但行为细节不同：

composer test：最简写法，仅匹配顶层脚本名；不支持通配符、不显示详细执行日志
composer run test：支持 --list 查看所有脚本、--no-dev 跳过 dev-only 脚本、--parse 预检语法
如果脚本名和内置命令冲突（比如你定义了 "install": "echo 'hi'"），composer install 仍会执行原生 install 逻辑，除非加 --no-plugins —— 这点极易误判

常见坑：脚本不执行、环境变量失效、Windows 下路径出错

这些问题几乎都源于执行上下文和 shell 行为差异：

脚本默认在项目根目录运行，但 npm、php 等命令可能依赖 PATH；CI 中建议显式指定完整路径，比如 /usr/bin/npm run build
Windows 用户注意：composer run 在 Git Bash / MSYS2 下会尝试调用 bash，但若系统没装 bash，会 fallback 到 cmd —— 此时 &&、$() 等语法直接失败
环境变量不会自动继承父 shell 的 export 结果；需要在脚本中重新 export，或改用 "test": "APP_ENV=test vendor/bin/phpunit"
脚本退出码非 0 时，Composer 默认中断后续操作；加 --no-interaction 不起作用，得靠 || true 显式忽略