如何将本地文件夹作为Composer的artifact仓库使用？（离线安装）

可以将本地文件夹用作Composer的artifact仓库，需将符合规范的ZIP/TAR包（根目录含合法composer.json）置于指定目录，并在项目composer.json中配置"type": "artifact"及对应本地路径，即可离线安装。

可以直接把本地文件夹当作 Composer 的 artifact 仓库来用，适合离线环境或内部包分发。关键不是“挂载”，而是让 Composer 把某个目录里的 ZIP/TAR 包当成可安装的源。

准备包文件：按规范打包

每个要安装的包必须是标准的 ZIP 或 TAR（.tar、.tar.gz、.tgz）格式，且压缩包根目录里必须包含 composer.json 文件（内容需合法，含 name、version 等必要字段）。

• 例如：myvendor/mypackage-1.2.0.zip 解压后结构应为：
  composer.json
src/...
tests/...
• 文件名建议遵循 {vendor}/{package}-{version}.{ext} 格式，Composer 会自动解析 vendor、name 和 version
• 不强制要求版本号在文件名里，但强烈推荐——否则需额外配置 artifact 的 packages 映射

配置 composer.json：声明 artifact 类型仓库

在你项目的 composer.json 中添加 repositories 配置，类型设为 artifact，路径指向存放 ZIP/TAR 的本地文件夹（支持相对或绝对路径）：

"repositories": [
  {
    "type": "artifact",
    "url": "./packages/"
  }
]

登录后复制

注意：url 是文件夹路径，不是 URL；该文件夹下所有 ZIP/TAR 都会被扫描，无需索引文件。

标签： js json composer 工具 解压 常见问题