必须在composer.json的repositories数组中正确配置type为"composer"的私有源，URL须以/结尾且能返回合法packages.json；同时需显式添加{"type":"composer","url":"https://packagist.org/","packagist":false}条目启用默认源，否则私有包无法匹配、公共包安装失败。
要在PHP项目中使用私有Composer仓库（如Artifactory、Satis或Private Packagist）安装包，必须让composer.json正确声明type为composer的仓库，并确保其URL可返回合法packages.json，否则require操作会静默跳过该源、直接报“Could not find package”。
配置composer类型仓库的基本结构
在项目根目录composer.json的根级添加repositories数组，其中每项type必须为"composer"，url值必须是HTTPS地址且以斜杠/结尾：
打开composer.json → 找到或新建"repositories"字段 → 写入如下结构（注意逗号和括号闭合）：
```json
{"type": "composer", "url": "https://my-repo.example.com/"}
【URL末尾的/不可省略】 缺少斜杠会导致Composer拼出https://my-repo.example.com/packages.json错误路径，实际服务端响应的是https://my-repo.example.com//packages.json而404；Nginx或CDN常因此返回403，但Composer只报“Could not fetch packages”，不提示真实原因。
必须显式启用packagist.org作为后备源
一旦定义了任何repositories数组，Composer就会关闭默认的packagist.org隐式源——哪怕你只加了一条私有仓库，monolog/monolog这类通用包也会装不上。
第一步：把私有仓库放在repositories数组最前面；
第二步：紧接着添加packagist.org条目，并显式设置"packagist": false（不是"packagist.org": false）；
第三步：确保该条目url为https://packagist.org，且同样以/结尾。
完整写法示例：
```json
{"repositories": [
{"type": "composer", "url": "https://my-repo.example.com/"},
{"type": "composer", "url": "https://packagist.org/", "packagist": false}
]}
注意：{"packagist.org": false}是旧版写法，2026年已失效；新写法必须是"packagist": false且与url同级。漏掉这一行，所有非私有包都会失败。
验证仓库是否真正可达
方法一：用curl直连packages.json
执行curl -I https://my-repo.example.com/packages.json，确认HTTP状态码为200，Content-Type含application/json。
方法二：检查返回内容是否含合法JSON结构
响应体必须是对象，顶层含packages字段，例如{"packages": {"vendor/name": [{"version": "1.0.0", "dist": {...}}]}}；若返回空对象{}、HTML页面或重定向到登录页，Composer将完全忽略该仓库。
方法三：运行composer show -p | grep my-repo
该命令列出当前生效的所有仓库；如果没出现你的域名，说明repositories语法错误或被上层配置覆盖（如存在vendor/composer/installed.json残留缓存）。
Artifactory上创建Composer仓库的关键设置
创建时必须选择Package Type为composer，不能选Generic或Remote（即使Remote URL填的是https://packagist.org）。
Local仓库：Repository Key随便填，但“Package Type”下拉框要手动点开选composer——这是唯一生效选项。
Virtual仓库：在“Repositories”列表中，必须把已启用的composer类型Local或Remote仓库拖进去；勾选“Enable Default Deployment Repository”，否则composer publish会拒绝上传。
【Remote仓库URL必须填上游源，不是你自己的Git地址】 比如你要代理Packagist，Remote的URL就得填https://packagist.org，而不是https://gitlab.com/xxx/yyy.git。
常见报错与对应修复
报错“Invalid repository type”：Artifactory后台仓库类型不是composer，而是Generic或Maven；重新创建并强制指定Package Type。
报错“Could not resolve packages”：packages.json返回了200但内容为空或格式非法；用浏览器或curl打开该URL，人工检查JSON结构。
报错“401 Unauthorized”：私有仓库启用了HTTP Basic认证，但未配置auth.json；运行composer config http-basic.my-repo.example.com username token，凭证才会透传。
