composer如何在离线环境下使用？（缓存与本地仓库方案）

离线安装 composer 时需提前在联网机生成本地仓库并禁用 packagist 回源：用 satis 构建 mirror，离线机配置 composer config repos.packagist false 并执行 composer install –no-dev –prefer-dist 重建 autoload。

离线安装时 composer install 报错“Could not fetch”怎么办

离线环境下，composer install 默认会尝试连接 packagist.org，失败后直接中断。这不是网络超时问题，而是 Composer 根本没走缓存逻辑——它默认只缓存成功下载的包，且不主动复用本地已有的 .zip 或 .tar.gz 文件。

关键不是“怎么跳过网络”，而是“怎么让 Composer 主动信任本地已有资源”。必须提前在有网机器上完成两件事：下载完整依赖包 + 生成可离线识别的仓库索引。

• 用 composer install --no-scripts --no-autoloader 在联网机跑一次，确保 vendor/ 和 composer.lock 齐全
• 执行 composer archive --format=zip --dir=./packages（需先 composer global require "hirak/prestissimo:^0.4" 启用并行下载，再配合 composer config --global repo.packagist composer https://packagist.org 确保源一致）
• 把整个 vendor/ 目录 + composer.lock + 生成的 packages/ 压缩包一并拷到离线机

用 composer config repositories 指向本地 zip 包目录

Composer 支持将本地文件夹伪装成 Composer 仓库，但只认特定结构：每个包必须是独立子目录，内含 composer.json 和压缩包（命名需匹配 vendor/name-version.zip）。手动整理太容易出错。

推荐用 toran-proxy 的轻量替代方案：composer-satis。它能把 composer.lock 里所有包一键打包并生成静态 packages.json。

• 在联网机运行：composer create-project composer/satis:dev-main satis --stability=dev --no-interaction
• 写一个 satis.json，关键字段：{"name": "local-mirror", "homepage": "file:///path/to/mirror", "repositories": [{"type": "composer", "url": "https://packagist.org"}], "require-all": true}
• 执行 php bin/satis build satis.json ./mirror，生成的 mirror/ 就是可离线使用的本地仓库
• 离线机执行：composer config repositories.local-mirror composer file:///path/to/mirror

composer update 在离线环境为何仍会报 DNS 错误

即使配置了本地仓库，composer update 仍可能触发对 packagist.org 的元数据请求——因为 Composer 默认开启 packagist.org 的“fallback”机制，只要本地仓库没覆盖某个包的某个版本，它就自动回源查询。

必须彻底禁用远程源。不是删掉 repositories 配置，而是显式关闭 fallback：

• 执行 composer config repos.packagist false（注意不是 packagist.org）
• 确认 composer config --list | grep repos 输出中 repos.packagist 值为 false
• 如果项目 composer.json 里写了 "repositories": [{"type": "packagist", "url": "https://packagist.org"}]，必须手动删掉这一段
• 再次运行 composer update --no-plugins --no-scripts，此时所有解析都只走本地 packages.json

离线部署后 autoload 失效或类找不到

常见错觉是“包装进来了，类就该能用”，但 Composer 的自动加载依赖 vendor/autoload.php 生成时的路径快照。如果离线机的项目路径和联网机不一致（比如从 /home/user/project 拷到 D:project），vendor/composer/autoload_static.php 里的绝对路径就会失效。

解决方案只有一个：在离线机上重新生成 autoloader，且不联网：

• 确保 vendor/ 已存在、composer.lock 已就位
• 执行 composer dump-autoload --optimize --classmap-authoritative
• 如果提示 Class not found，说明某些包的 autoload 配置依赖动态扫描（如 "psr-4": {"": "src/"}），此时必须保证 src/ 目录结构与 composer.lock 记录的一致

最稳的做法：所有离线部署，都在目标环境的最终路径下执行一遍 composer install --no-dev --prefer-dist，哪怕 vendor 已存在——它只会校验哈希、重建 autoload，不碰网络。