Composer离线环境怎么配置批量解压脚本-composer-PHP中文网

离线批量解压zip包必须严格匹配composer.lock中的dist.shasum，仅适用于artifact仓库场景；需禁用网络、验证dist.type为zip、解压至指定结构目录，并配合正确repositories配置，不可跳过composer原生install流程。

composer离线环境怎么配置批量解压脚本

离线环境批量解压 ZIP 包必须先确认 dist 格式和缓存路径

Composer 离线安装依赖时，composer install --prefer-dist 本质是下载并解压 ZIP 包（不是 Git clone），所以“批量解压”不是通用操作，而是对 ~/.composer/cache/files/ 下已缓存的 ZIP 文件做预处理。关键前提是：这些 ZIP 必须与 composer.lock 中每个包的 dist.shasum 完全匹配，否则解压后 composer install 会校验失败并报 Hash mismatch。

常见错误现象：unzip: cannot find or open vendor/acme/pkg.zip 或 Failed to extract acme/pkg: (RuntimeException) Could not decompress ...——不是 ZIP 损坏，而是路径不对或文件名被 Composer 重命名过（如 acme/pkg/abc123.zip）。

Linux/macOS 默认缓存路径是 ~/.composer/cache/files/；Windows 是 %APPDATA%\Composer\Cache\files\
ZIP 文件名格式为 vendor/name/sha384-hash.zip，其中 hash 来自 composer.lock 的 dist.shasum 字段
不能直接解压到 vendor/ 目录下——Composer 有自己的一套提取逻辑（含 symlink 处理、autoload 注册等），手动解压会跳过这些步骤，导致 Class not found

用 shell 脚本批量解压前必须先禁用网络并验证 lock 文件

脚本执行前不设 COMPOSER_DISABLE_NETWORK=1，哪怕 ZIP 全在本地，composer install 仍会尝试请求 https://repo.packagist.org/packages.json 并卡死。而 composer.lock 若含 "source": {"type": "git", "url": "..."} 这类条目，脚本再怎么解压也无效——Git 源无法离线还原。

先运行 composer config --global repo.packagist false 彻底禁用默认源
检查 composer.lock 中所有包的 dist.type 是否均为 zip（不是 tar 或 git）
确认 dist.url 字段是相对路径或可映射到本地 ZIP（如 https://packages.example.com/acme/pkg/abc123.zip 需提前重定向到本地文件系统）

真正可用的批量解压脚本只适用于 artifact 仓库场景

如果你用的是 "type": "artifact" 仓库（即把所有 ZIP 打包进一个目录供 Composer 扫描），那才需要批量解压准备阶段。但注意：artifact 类型只解决顶层包，子依赖仍需从 packagist 或其他源拉取——除非你已用 composer install --no-dev --prefer-dist 在联网机完整跑过一遍，并把整个 ~/.composer/cache/files/ 拷过去。

示例脚本（Linux/macOS，假设 ZIP 全在 /opt/composer-artifacts/）：

Discussion Composer

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

下载

#!/bin/bash
cd /opt/composer-artifacts
for zip in *.zip; do
  if [[ -f "$zip" ]]; then
    name=$(basename "$zip" .zip)
    mkdir -p "extracted/$name"
    unzip -q "$zip" -d "extracted/$name"
  fi
done

但这只是准备动作，后续仍要配置 composer.json：

"repositories": [
  {
    "type": "artifact",
    "url": "/opt/composer-artifacts/extracted/"
  }
]

注意：url 必须指向解压后的目录（不是 ZIP 所在目录），且该目录下必须是按 vendor/name/ 结构组织的子目录。

别写“自动解压 + composer install”一体化脚本

试图用脚本把 ZIP 解压、改权限、补 autoload、清 cache 一气呵成，反而容易出错。Composer 的 install 流程本身已包含解压、校验、symlink、autoload 生成等原子步骤，强行拆开会绕过关键校验点。

composer install --no-plugins --no-scripts --no-autoloader 已足够快，它只做元数据比对和 ZIP 提取，不触发任何钩子
真正要补的是 composer dump-autoload -o，不是手动复制 vendor/autoload.php
如果目标机器磁盘空间紧张，宁可删掉 ~/.composer/cache/files/ 后只保留 vendor/ 和 composer.lock，靠 composer install --no-network 读 lock 文件跳过下载

最易被忽略的一点：composer install 在离线时仍会访问 vendor/composer/installed.json 和 vendor/composer/ClassLoader.php，这两个文件若被脚本误删或权限设错（如非 PHP 进程用户写入），会导致后续所有 autoload 失败，且错误信息不提示具体原因。