使用本地文件系统作为包源或启用缓存机制可实现composer离线安装，通过配置path或artifact类型仓库指向本地包文件，在无网络环境下安装依赖；Composer默认缓存已下载包，可自定义cache-dir提升复用效率；对于多项目共享，可构建静态文件镜像并用http服务暴露，替换默认源为本地镜像地址，确保离线时仍能正常安装，关键在于路径正确、版本匹配及文件命名规范。
为 Composer 配置离线镜像或本地缓存，核心思路是使用本地文件系统作为包源，或通过启用缓存机制减少对外部网络的依赖。这在无网络环境、内网部署或提升安装速度时非常有用。
使用本地文件仓库作为离线镜像
你可以将已下载的 Composer 包复制到本地目录，并将其配置为一个文件型仓库。
步骤如下：
- 找到 Composer 的缓存目录（通常位于 ~/.composer/cache/files 或 C:Users用户名appDataRoamingComposercachefiles）
- 将需要的包 tar 文件复制到一个统一的本地目录，例如：/path/to/local-repo/dist
- 在项目根目录的 composer.json 中添加仓库配置：
{ “repositories”: [ { “type”: “path”, “url”: “/path/to/local-repo/dist” } ] }
注意：这种写法适合链接本地路径中的压缩包或源码目录。若你已有打包好的 dist 文件，也可以使用 artifact 类型：
{ “repositories”: [ { “type”: “artifact”, “url”: “/path/to/artifacts/” } ] }
把所有 .tar 或 .zip 包放在此目录中，Composer 会自动扫描并使用它们。
启用并管理 Composer 本地缓存
Composer 默认会缓存已下载的包，但你可以优化其行为以支持弱网或半离线场景。
- 查看当前缓存路径：composer config –list | grep cache
- 可自定义缓存目录：composer config -g cache-dir “/your/local/cache”
- 确保以下目录有足够空间：files（存放 .tar）、repo（VCS 元数据）、vcs
当你在一个有网的环境中运行过 composer install 后，相关包会被缓存。之后断网时，只要不清理缓存，再次安装相同版本的包，Composer 可直接使用本地副本。
构建私有镜像用于多项目共享
若需服务多个项目或团队，可搭建一个简单的静态文件镜像。
- 使用 composer mirror 工具或脚本批量下载所需包到本地
- 组织成符合 Composer 结构的静态资源目录
- 通过 HTTP 服务器（如 nginx）暴露该目录
- 在 composer.json 中替换默认源：
{ “repositories”: [ { “type”: “composer”, “url”: “http://localhost/composer-mirror” } ] }
这样即使没有互联网连接，只要本地镜像服务运行，就能正常执行依赖安装。
基本上就这些。关键是利用好 path、artifact 和缓存机制，在无网环境下让 Composer 能找到已有的包文件。不复杂但容易忽略细节，比如路径权限和文件命名规范。确保离线包的版本与 require 一致，才能顺利加载。