composer脚本配置在项目根目录的composer.json文件的”scripts”字段中，定义后对应事件触发时自动执行；值可为字符串、数组或对象，支持php回调和shell命令，执行失败默认中断流程。
scripts 配置在哪写、怎么生效
Composer 的脚本事件由 composer.json 里的 "scripts" 字段控制，它是个 JSON 对象，键是事件名（比如 post-install-cmd），值是命令或数组。脚本不会自动启用或禁用——只要定义了，对应事件触发时就会执行；删掉某条就等于禁用它。
常见错误：把脚本写在 scripts-dev 或自定义字段里，Composer 完全不识别；或者用了错误的事件名（如 post-update，正确是 post-update-cmd）。
-
composer.json必须在项目根目录，且格式合法（可用composer validate检查） - 脚本值可以是字符串（单条命令）、字符串数组（顺序执行）、或对象（带
script和Event字段的高级写法） - 内置事件分两类：命令触发型（如
post-install-cmd）和 git 钩子型（如pre-push），后者需配合composer run-script手动调用
如何临时跳过某个脚本执行
不是“禁用”，而是运行时绕过——最常用的是 --no-scripts 参数，它会全局屏蔽所有脚本，包括 autoload-dump 这类关键操作，慎用。
更精准的做法是用 --no-plugins（如果脚本来自插件），或给特定脚本加条件判断。但 Composer 原生不支持 per-script 开关，所以得靠脚本自身逻辑控制。
-
composer install --no-scripts：跳过所有 install/update 相关脚本 -
composer run-script post-install-cmd --no-plugins：只运行该脚本，但不加载插件带来的额外脚本 - 若脚本是 PHP 回调（如
"post-install-cmd": "MyClass::doSomething"），可在方法里读取环境变量（如getenv('SKIP_POST_INSTALL')）提前 return
脚本执行失败会导致命令中断吗
默认会。只要脚本返回非零退出码（比如 shell 命令失败、PHP 抛出未捕获异常），Composer 就中止后续流程，并报错 Script ... handling the ... event returned with Error code ...。
这不是 bug，是设计行为：确保构建一致性。但有时你只想记录日志或做清理，不希望失败阻断主流程。
- 用
&&或|| true在 shell 脚本末尾兜底（如"php build.php || true"） - PHP 回调里 try/catch 全部异常，并显式
return 0 - 注意：某些关键事件（如
autoload-dump）失败后自动加载器可能失效，即使命令“成功”也别信
scripts 中的路径和环境变量怎么处理
脚本运行时工作目录是 composer.json 所在目录，不是 vendor 或 bin。环境变量方面，Composer 会透传宿主环境变量，但不会自动注入项目专属变量（比如 APP_ENV）。
容易踩的坑是路径硬编码（如 php ./scripts/deploy.php），一旦项目结构变化就崩；还有依赖 $_SERVER['HOME'] 这类不可靠变量。
- 用
$COMPOSER_HOME获取 Composer 配置目录，$PWD是当前项目路径（shell 脚本中可用） - PHP 回调里推荐用
__DIR__或getcwd()构造相对路径，避免假设项目根目录名 - 敏感配置（如 API 密钥）不要写死在
scripts里，改用.env+vlucas/phpdotenv加载
事情说清了就结束。真正麻烦的不是启不启用脚本，而是当多个包都注册了同名事件（比如十几个包都写了 post-autoload-dump），执行顺序、错误传播和调试路径会立刻变复杂。