如何在离线环境中使用 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 或工具生成符合结构的本地仓库目录）。

标签： composer 离线安装 php js json 操作系统 工具 本地仓库