Composer的scripts本身不提供原子性保障,需手动设计回滚逻辑或用set -e/try-catch实现“全成功或全中断”,并借助pre-/post-钩子明确执行边界。

Composer 的 scripts 不是原子操作,得靠外部手段保序
Composer 的 scripts 本身不提供原子性保障——它只是按顺序执行 shell 命令或 PHP 回调,中途出错默认继续(除非显式配置 "stop-on-failure": true)。所谓“原子脚本逻辑”,实际是指:要么全部成功,要么全部回滚/中断,且不留下半截状态。这得靠你手动设计,不是 Composer 自带能力。
用 script + pre-*/post-* 钩子控制执行边界
常见误区是把所有逻辑塞进一个 custom-deploy 脚本里,结果某步失败后数据库已迁移、文件已覆盖,但缓存没清完。正确做法是拆解为可验证、可逆的阶段,并利用 Composer 钩子明确边界:
-
pre-install-cmd和pre-update-cmd适合做前置检查(如确认 DB 连接、磁盘空间) - 核心逻辑放在自定义脚本(如
deploy),内部用set -e(bash)或exit on error(PowerShell)强制中断 -
post-install-cmd仅用于收尾(如php artisan optimize:clear),不承担主流程
示例 composer.json 片段:
"scripts": {
"deploy": [
"@pre-deploy",
"sh -c 'set -e; php bin/migrate.php && php bin/build-assets.php && cp .env.prod .env'",
"@post-deploy"
],
"pre-deploy": "php -r \"if (!is_writable('storage')) die('storage not writable');\"",
"post-deploy": "php artisan config:clear"
}
PHP 脚本比 shell 更容易实现“事务感”
shell 脚本难做回滚(比如 cp 覆盖后想还原,得提前备份);而 PHP 脚本能自然封装 try/catch 和清理逻辑。关键点:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 所有副作用操作(写文件、改 DB、发 HTTP)都包装进方法,失败时触发
finally或显式rollback() - 避免在脚本里直接调用
exec('git pull')这类黑盒命令,改用symfony/process捕获输出和退出码 - 状态标记文件(如
deploy.lock)必须用fopen(..., 'x')(独占创建)防止并发冲突
简例:
// scripts/deploy.php
$steps = [__DIR__.'/migrate.php', __DIR__.'/build.php'];
foreach ($steps as $step) {
if (0 !== $code = (int) shell_exec("php $step 2>&1; echo $?")) {
throw new RuntimeException("Step failed: $step (exit $code)");
}
}
别忽略 composer install --no-scripts 的破坏力
CI/CD 流水线常加 --no-scripts 防意外执行,但这会让所有 pre-*/post-* 钩子静默跳过。如果你的部署依赖 post-autoload-dump 生成 classmap 或触发插件初始化,漏掉就可能运行时报 Class not found。
- CI 中若需执行脚本,明确写
composer install --no-interaction(默认启用 scripts) - 用
composer run-script deploy --no-dev替代直接php scripts/deploy.php,确保环境变量(如COMPOSER_DEV_MODE)一致 - 本地开发时
composer install触发的post-autoload-dump可能和 CI 环境不同(比如 classmap vs psr-4),导致行为差异
真正麻烦的是那些没报错但逻辑错位的情况——比如 post-autoload-dump 里注册了服务提供者,却因 --no-scripts 没跑,容器里就缺了这个服务。










