离线使用 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 或工具生成符合结构的本地仓库目录）。
用 --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 路径匹配——只要提前准备好、验证好、关掉网络，就能稳稳装上。
