必须设 composer_disable_network=1 才能离线安装,否则所有参数无效;需提前下载 dist 包至 cache/files/ 并保留 cache/repo/packages.json;离线机须同步缓存路径且 lock 文件中所有包 dist.type 必须为 zip/tar。

根本不能直接执行 composer install——它默认必联网拉取 packages.json 和 dist 包,断网时会卡在 Loading composer repositories 或报 Could not fetch https://repo.packagist.org/packages.json。离线安装不是“换参数就能跑”,而是必须提前切断网络通路、固化资源、对齐环境。
必须设 COMPOSER_DISABLE_NETWORK=1,否则所有参数都无效
这是离线操作的硬性前提,不是可选项。不设这个环境变量,--no-plugins、--no-scripts、甚至 --offline(该参数根本不存在)全无作用。Composer 会在元数据校验、插件初始化、post-install-cmd 阶段偷偷发 DNS 请求。
- Linux/macOS:命令前加前缀,例如
COMPOSER_DISABLE_NETWORK=1 composer install --no-dev --prefer-dist --no-scripts --no-plugins - Windows CMD:先运行
set COMPOSER_DISABLE_NETWORK=1,再执行composer install - PowerShell:运行
$env:COMPOSER_DISABLE_NETWORK="1",再执行命令 - 验证是否生效:在离线机上执行
composer config --list | grep disable,应看到disable-network显示为true
vendor 目录不能直接拷贝,必须用 --no-install + cache 提取
直接打包当前 vendor/ 同步到另一台机器,大概率失败。原因包括:post-install-cmd 脚本在离线环境下无法执行、软链接跨系统失效、扩展依赖(如 ext-redis)未编译。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 正确做法是在有网机器上运行:
composer install --no-install --prefer-dist --no-scripts,这会让 Composer 下载所有 dist ZIP 到vendor/composer/cache/files/,但不解压 - 同时确认
vendor/composer/cache/repo/https---packagist.org/packages.json存在且非空——它记录了包名与 ZIP 文件路径的映射,缺了它,离线时根本找不到本地包 - 打包时必须包含整个
cache/目录(含files/和repo/),不能只拷files/ - 离线机上需同步设置缓存路径:
composer config --global cache-dir /path/to/restored/cache
离线命令必须带 --prefer-dist,且 lock 文件里不能含 source 类型
--prefer-dist 是硬性要求。只有 dist 包(ZIP/TAR)才走缓存路径;如果 composer.lock 里某包的 dist.type 是 source(比如 "type": "git"),即使缓存齐全,COMPOSER_DISABLE_NETWORK=1 下也会直接退出,不报错也不提示。
- 生成 lock 文件时,确保用的是
--prefer-dist(开发机执行composer update --prefer-dist或composer install --prefer-dist) - 检查
composer.lock中每个包的dist字段:"url"应为 HTTPS ZIP 地址,"type"应为zip或tar,不能是git或hg - 若项目含私有包或 VCS 依赖,必须改用
type: package+ 本地路径方式配置仓库,例如:"repositories": [{"type": "package", "package": {"name": "my/private", "version": "1.0.0", "dist": {"url": "/path/to/my-private-1.0.0.zip", "type": "zip"}}}]
最容易被忽略的是缓存目录结构完整性——repo/ 和 files/ 必须共存,且 packages.json 里的 SHA256 值要和 ZIP 文件实际哈希一致。哪怕只少一个文件,composer install 就会静默失败,而不是报错。










