composer中如何配置satis私有仓库_composer搭建企业级镜像服务器【详解】

不能直接用 composer install 拉取私有包，因 Composer 默认只认 Packagist 官方源，私有包名（如 acme/utils）在 Packagist 不存在，会报错“Could not find package acme/utils”，必须通过 repositories 显式配置私有仓库地址。

为什么不能直接用 composer install 拉取私有包？

因为 Composer 默认只认 Packagist 官方源，私有仓库的包名（比如 acme/utils）在 Packagist 上不存在，composer install 会直接报错：Could not find package acme/utils。必须显式告诉 Composer：“这个包去哪找”。

配置 satis 仓库的两种核心方式

satis 本身不提供 HTTP 服务，它只生成静态 JSON 和 ZIP 包。你需要用 Web 服务器（如 Nginx/Apache）托管生成的 packages.json，再让 Composer 通过 repositories 指向它。

• 方式一：全局配置（推荐给团队统一镜像）
  运行 composer config -g repositories.acme '{"type": "composer", "url": "https://mirrors.example.com/satis/"}'
• 方式二：项目级配置（适合单个项目临时接入）
  在项目 composer.json 中添加：

  {
      "repositories": [
          {
              "type": "composer",
              "url": "https://mirrors.example.com/satis/"
          }
      ]
  }

• 注意：url 必须以 / 结尾，否则 Composer 会拼出错误路径（如 https://mirrors.example.com/satis/packages.json → 实际要的是 https://mirrors.example.com/satis//packages.json）

satis.json 关键字段怎么写才不出错？

很多团队卡在生成失败或包漏掉，根源常是 require 和 archive 配置不当。

墨鱼aigc

一款超好用的Ai写作工具，为用户提供一键生成营销广告、原创文案、写作辅助等文字生成服务。

下载

• name 和 homepage 只是元信息，不影响功能，但建议填真实域名
• require 要写具体包名 + 版本约束，不是通配符：
  ✅ 正确："acme/utils": "dev-main"
  ❌ 错误："acme/*": "*"（satis 不支持 glob）
• 如果需要下载 ZIP 包（比如离线部署），必须启用 archive：

  "archive": {
      "directory": "dist",
      "format": "zip",
      "skip-dev": true
  }

  否则 composer install --prefer-dist 会退回到 --prefer-source，拉 Git 仓库而非 ZIP
• 私有 Git 仓库需提前配置好 SSH key 或使用 HTTPS + token，satis 构建时会 clone，失败则跳过该包且不报错（静默丢包）

为什么 composer update 很慢，甚至超时？

根本原因不是网络，而是 satis 生成的 packages.json 太大，Composer 加载时内存爆满或解析超时。

• 默认 satis 会把所有匹配包的所有版本都写进一个 JSON 文件，100 个包 × 平均 20 个版本 = 2000+ 条目，JSON >5MB
• 解决方案：按组织分拆镜像
  为每个部门/业务线单独跑 satis，satis.json 中 require 只写自己关心的包，生成独立 packages.json
• 加缓存头：Nginx 配置 add_header Cache-Control "public, max-age=3600";，避免每次 composer update 都重请求
• 禁用 Packagist 回退：在 composer.json 加 "packagist.org": false，防止 Composer 在私有源查不到时自动切到公网，拖慢速度还暴露内部包名