如何在离线环境中使用 Composer 安装依赖？

离线使用 Composer 安装依赖的核心是提前在联网机下载 ZIP 包并复制到离线机，配置本地仓库后执行 composer install --no-network --prefer-dist；需确保 composer.lock 与 ZIP 文件的版本及 shasum 严格匹配。

在离线环境中使用 Composer 安装依赖，核心思路是：提前在有网络的机器上下载好所有依赖包（包括源码和 ZIP 归档），生成可复用的本地包仓库，再将这些文件复制到目标离线机器上，通过配置 Composer 使用本地路径完成安装。

提前在联网机器上准备依赖包

这是最关键的一步。不能直接在离线机上运行 composer install，因为会失败。你需要在一台环境一致（PHP 版本、扩展、操作系统位数等尽量接近）的联网机器上操作：

• 确保项目已有 composer.lock 文件（由 composer update 或首次 composer install 生成）
• 运行 composer install --no-install --prefer-dist 只解析依赖，不下载
• 用 composer install --prefer-dist --no-scripts --no-plugins 正常下载所有 dist 包（ZIP 文件）到 vendor/composer/installed.json 对应的缓存目录（通常是 ~/.composer/cache/files/）
• 或者更稳妥：用 composer-offline 工具一键打包全部依赖 ZIP 和 lock 文件

把依赖包复制到离线机器并配置本地仓库

将联网机器上下载好的所有 ZIP 包（位于 ~/.composer/cache/files/ 下的子目录）整个复制到离线机的某个固定路径，比如 /opt/composer-offline-cache。然后在离线机的项目根目录下创建或修改 composer.json，添加自定义仓库：

{
  "repositories": [
    {
      "type": "package",
      "package": {
        "name": "monolog/monolog",
        "version": "2.10.0",
        "dist": {
          "url": "/opt/composer-offline-cache/monolog/monolog/5e7b4c8d9f3a5e7b4c8d9f3a5e7b4c8d9f3a5e7b.zip",
          "type": "zip"
        }
      }
    }
  ]
}

但手动写太麻烦。推荐做法是：用 composer config repositories.0 type path 配合本地 packages.json 文件，或直接使用 composer install --repository-url=file:///opt/composer-offline-cache（需先用 composer archive 或工具生成符合结构的本地仓库目录）。

Uni-CourseHelper

私人AI助教，高效学习工具

94

查看详情

用 --no-network 强制离线模式安装

在离线机器上执行安装命令时，必须显式禁用网络请求，否则 Composer 仍会尝试访问 packagist.org：

• 运行 composer install --no-network --prefer-dist
• 确保 composer.lock 已存在且与本地 ZIP 包版本严格匹配（版本号、commit hash 等）
• 如果提示 “Package not found”，检查 ZIP 文件名是否与 lock 中的 dist.shasum 和 dist.url 路径一致；建议用 composer-offline 工具自动生成校验无误的包集

进阶：构建私有离线 Packagist 镜像（适合多项目）

如果团队长期处于离线环境，可搭建轻量级本地镜像：

• 用 composer-mirror 工具同步 packagist.org 元数据 + dist 包到内网服务器
• 在离线机的全局 config 中设置：composer config -g repos.packagist composer https://internal-mirror.example.com
• 后续所有 composer install 自动走内网，无需每次手动搬运

基本上就这些。离线用 Composer 不复杂但容易忽略锁文件一致性与 dist 路径匹配——只要提前准备好、验证好、关掉网络，就能稳稳装上。

以上就是如何在离线环境中使用 Composer 安装依赖？的详细内容，更多请关注php中文网其它相关文章！