如何将Composer应用于私有云仓库，构建企业级管理部署方案？

本文共计1041个文字，预计阅读时间需要5分钟。

私有云仓库使用时，若遇到以下问题：

怎么让 Composer 正确识别并访问私有云仓库

必须显式声明仓库类型为 composer，且 URL 指向的是可公开访问的 JSON 元数据根路径（如 https://packages.internal/api/），不是 Git 地址或 Web 页面。Satis 生成的静态仓库、Private Packagist 实例、或自建的 Packagist 兼容服务都符合此结构。

• 错误写法："url": "git@internal.git:team/lib.git" —— 这是 VCS 源，仅用于索引，不能作为安装源
• 正确写法："type": "composer", "url": "https://packages.internal/"
• 若私有仓库启用了 HTTP Basic Auth，必须提前配置：php composer.phar config http-basic.packages.internal username password
• 使用 canonical: true 强制只从此源查找包，避免因其他镜像干扰导致版本错乱

为什么设置了私有源，composer install 还是去 packagist.org 找包

因为 Composer 默认启用 packagist.org 作为全局源，除非你显式禁用它。