如何实现 composer 的离线安装 (Offline Installation)？

离线安装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 并配置缓存目录

建议指定一个集中缓存路径，便于复制。

安装依赖并生成 lock 文件

使用 --prefer-dist 确保以压缩包形式下载，更节省空间且适合离线分发。

确认所有包已缓存

Supercreator

AI视频创作编辑器，几分钟内从构思到创作。

80

查看详情

如果最后一步成功，说明所有依赖已在缓存中。若失败，说明仍有包未缓存，需检查网络并重试安装。

3. 迁移至离线环境

将以下内容复制到目标机器：

• 项目完整目录（含 composer.json 和 composer.lock）
• Composer 缓存目录（如前面设置的 /path/to/local-cache）
• Composer 可执行文件（composer.phar）

在目标机器上恢复缓存：

4. 离线安装依赖

在离线机器的项目目录中执行：

参数说明：

• --prefer-dist：优先使用压缩包，避免尝试源码克隆
• --no-plugins：防止插件尝试联网
• --no-scripts：跳过 post-install 脚本（可选，视项目而定）

只要 lock 文件完整且缓存齐全，此命令将不依赖网络完成安装。

基本上就这些。关键在于提前缓存和验证。只要流程走对，Composer 离线部署稳定可靠。

以上就是如何实现 composer 的离线安装 (Offline Installation)？的详细内容，更多请关注php中文网其它相关文章！