Composer 本身不提供草稿功能,无--draft或--dry-run等预演开关;install/update为原子操作,直接构建vendor;--dry-run仅输出计划不执行,无法替代真实验证。

composer 本身不提供“用临时文件做草稿”的功能,也没有 --draft、--dry-run 或类似开关来预演安装/更新行为并把结果暂存在临时目录里。所谓“草稿”,在 Composer 场景中常被误解为:想先试装到某处、确认没问题再正式写入 vendor,或想保留中间下载/解压产物供调试——但这些都不是 Composer 的设计目标。
为什么 composer install/update 不走“草稿目录”流程
Composer 的 install/update 是原子性操作:它一边下载解压包到 ~/.composer/cache/(缓存),一边直接在项目根目录构建 vendor/ 和 vendor/composer/ 下的元数据文件(如 installed.json、autoload_static.php)。整个过程没有“先写草稿、再搬移”的阶段。
常见误判来源:
- 看到
/tmp/composer_*.zip文件,以为是“草稿包”——其实是 PHP 解压时用的系统临时文件,sys_get_temp_dir()返回路径下的残留,不是 Composer 主动管理的草稿 - 以为
composer.lock是草稿版composer.json——其实它是精确记录当前vendor/状态的快照,不可编辑、不参与执行逻辑
想安全预演?用 --dry-run + 人工检查依赖树
composer install --dry-run 和 composer update --dry-run 是最接近“草稿”语义的操作:它跳过实际写文件,只输出将要安装/升级/删除的包列表,并校验 composer.json 与 composer.lock 是否一致。
关键点:
- 它不生成任何临时 vendor 目录,也不解压任何 zip 包——所以无法用于测试自动加载、运行时兼容性或框架命令
- 输出内容取决于当前
composer.lock是否存在:install --dry-run在有 lock 时才有效;若无 lock,它会报错“Your lock file does not contain a compatible set of packages” - 搭配
composer show --tree可人工核对依赖层级,但无法替代真实执行
真要留一份可验证的“草稿 vendor”?得自己建隔离环境
如果你需要一个可运行、可调试、又不影响主 vendor/ 的临时依赖副本,唯一可靠方式是手动构造隔离上下文:
- 复制当前项目目录(如
cp -r . /tmp/my-project-draft),进该目录执行composer install——这是真正“草稿级”验证,但耗磁盘和时间 - 用
COMPOSER_HOME=/tmp/composer-draft-home composer install指向独立缓存目录,避免污染全局~/.composer/cache/,但vendor/仍写入当前项目 - 改
bin-dir或自定义vendor-dir(需在composer.json中静态配置"config": {"vendor-dir": "vendor-draft"}),再配合脚本切换 —— 注意:此配置不能运行时覆盖,且会破坏大多数框架对vendor/的硬编码路径假设
所有这些方案都绕不开一个事实:Composer 没有草稿模式,它的“确定性”来自 composer.lock + 精确版本锁定,而不是预执行沙箱。
容易被忽略的复杂点
很多人试图用 composer create-project --stability=dev --no-install 来“先拉代码再决定装不装”,但这只是跳过 install 步骤,仍会写 composer.lock 和 vendor/ 骨架,且后续 composer install 会按 lock 文件强制还原——它不是草稿,是半截安装。
真正需要草稿语义的场景(如 CI 中预检、灰度部署验证),应交由容器或 VM 环境完成,而非依赖 Composer 自身机制。Composer 的角色是“确定性交付”,不是“可逆实验”。


















