离线安装Composer依赖的关键是提前在联网环境缓存所有包并生成lock文件,具体步骤包括:配置缓存目录、执行composer install --prefer-dist下载依赖、验证缓存完整性,随后将项目文件、composer.lock、缓存目录及composer.phar一并迁移至离线机器,最后运行composer install --prefer-dist --no-plugins --no-scripts完成无网络依赖安装。

Composer 的离线安装在没有网络或网络受限的环境中非常实用。虽然 Composer 默认依赖网络获取包信息和下载依赖,但通过合理准备和缓存,完全可以实现离线使用。
1. 理解 Composer 离线原理
Composer 本身不需要离线安装——它是一个 PHP 脚本工具,只需一次下载即可运行。真正的“离线安装”是指:在无网络环境下,执行 composer install 来还原项目依赖。
实现的关键是提前在有网络的机器上:
- 下载并缓存所有需要的依赖包
- 生成可离线使用的 composer.lock
- 将缓存和项目一起迁移到目标机器
2. 准备阶段(联网环境)
在可以访问互联网的机器上完成以下步骤:
确保已安装 Composer 并配置缓存目录
composer config cache-dir /path/to/local-cache建议指定一个集中缓存路径,便于复制。
安装依赖并生成 lock 文件
composer install --prefer-dist使用 --prefer-dist 确保以压缩包形式下载,更节省空间且适合离线分发。
确认所有包已缓存
composer clear-cachecomposer install --no-download如果最后一步成功,说明所有依赖已在缓存中。若失败,说明仍有包未缓存,需检查网络并重试安装。
3. 迁移至离线环境
将以下内容复制到目标机器:
- 项目完整目录(含 composer.json 和 composer.lock)
- Composer 缓存目录(如前面设置的 /path/to/local-cache)
- Composer 可执行文件(composer.phar)
在目标机器上恢复缓存:
composer config cache-dir /offline/machine/cache/pathcp -r /source/cache/* /offline/machine/cache/path/4. 离线安装依赖
在离线机器的项目目录中执行:
composer install --prefer-dist --no-plugins --no-scripts参数说明:
- --prefer-dist:优先使用压缩包,避免尝试源码克隆
- --no-plugins:防止插件尝试联网
- --no-scripts:跳过 post-install 脚本(可选,视项目而定)
只要 lock 文件完整且缓存齐全,此命令将不依赖网络完成安装。
基本上就这些。关键在于提前缓存和验证。只要流程走对,Composer 离线部署稳定可靠。










