composer怎么跳过脚本执行_composer install –no-scripts【精简】

1次阅读

composer install 默认执行脚本是设计行为,因脚本被视为安装流程自然延伸;–no-scripts 仅跳过 composer.json 中明确定义的脚本及绑定的标准事件,不生效时多因插件绕过或脚本来源误判。

composer怎么跳过脚本执行_composer install –no-scripts【精简】

composer install 为什么还会跑脚本

默认情况下 composer install 会执行 post-install-cmdpre-autoload-dump 等脚本,哪怕你没手动加 --scripts。这不是 bug,是 Composer 的设计逻辑:它把脚本当作安装流程的自然延伸。

常见错误现象:composer install --no-scripts 仍触发某些钩子,比如 laravelphp artisan optimize:clear 还在跑——那大概率是因为脚本被写进了 scripts 段且绑定了 post-install-cmd,而 --no-scripts 只跳过 *所有* 脚本,但部分插件或自定义 installer 可能绕过该开关(比如通过事件监听器直接调用)。

  • --no-scripts 是唯一标准方式,别信 --skip-scripts--disable-scripts(不存在)
  • 如果项目用了 composer-plugin-api >=2.0 的插件(如 laravel-shift/composer-installer),它们可能无视 --no-scripts,得看插件文档是否支持 COMPOSER_NO_SCRIPTS=1 环境变量
  • CI/CD 中建议统一用 COMPOSER_NO_SCRIPTS=1 composer install,比命令行参数更稳定

哪些脚本会被 –no-scripts 真正跳过

--no-scripts 只影响 composer.jsonscripts 下明确定义的命令,以及它们绑定的标准事件(如 post-install-cmdpre-autoload-dump)。不会影响:

  • Autoloader 生成本身(那是 Composer 核心行为,和脚本无关)
  • 第三方插件自己注册的事件监听器(除非插件主动检查 COMPOSER_NO_SCRIPTS
  • require-dev 包里的脚本(只要没被主项目的 scripts 显式调用,就不会跑)

典型场景:本地开发想快速装包不跑 php artisan migrate:fresh,或 CI 构建时避免因缺少 DB 配置导致 post-update-cmd 失败。

遇到 –no-scripts 不生效怎么办

先确认是不是脚本根本不在 scripts 里,而是由插件硬编码触发。运行 composer install -v,看日志里执行的是 Executing script 还是 Running plugin X

  • 如果是插件行为,查该插件是否读取 COMPOSER_NO_SCRIPTS 环境变量;不支持就只能临时删掉 composer.json 中对应插件配置
  • 检查是否有 composer.lock 里记录了旧版本依赖,其安装器自带脚本逻辑;可尝试 rm composer.lock && composer install --no-scripts
  • 极少数情况是 vendor/bin 下二进制被其他工具(如 roave/better-Reflection)自动调用,和 Composer 无关,得查调用链

替代方案:只禁用特定脚本而非全部

Composer 原生不支持“跳过某一个脚本”,但可通过环境变量 + 脚本内判断实现软跳过:

"scripts": {   "post-install-cmd": [     "@php -r "if (getenv('SKIP_MIGRATE')) exit;" && php artisan migrate:fresh --no-interaction"   ] }

这样就能用 SKIP_MIGRATE=1 composer install 精准控制,比全局 --no-scripts 更安全——尤其当其他脚本(如生成 autoload、清理缓存)仍需执行时。

真要跳过脚本,--no-scripts 是唯一直接手段;但“不生效”往往不是它的问题,而是脚本来源被误判了。

text=ZqhQzanResources