阿里云OSS是Composer镜像源的静态文件存储底座，所有.zip包及元数据均以校验后对象形式存于OSS，URL直映射Object路径；需开启公共读、严格对齐dist URL与OSS路径、正确设置Content-Type为application/zip。
阿里云 OSS 是 Composer 镜像源同步的存储底座
阿里云镜像不是反向代理，而是用自研同步服务把 packagist.org 元数据和 ZIP 包完整拉下来，存进 OSS（对象存储），再通过 CDN 分发。OSS 在这里承担真实文件存储角色——所有 .zip 包、packages.json、p2/provider-*.json 都以静态对象形式存在，URL 直接映射到 OSS Object Path。
关键点在于：你看到的 https://mirrors.aliyun.com/composer/p/laravel/framework/10.0.0.zip 并非动态生成，而是同步程序提前下载、校验 SHA256 后上传至 OSS 的副本。这意味着：
- OSS Bucket 必须开启公共读（或配合 CDN 鉴权策略），否则客户端无法直连下载
- ZIP 包路径由镜像服务按固定规则生成，例如
p/{vendor}/{package}/{version}.zip，不能随意改目录结构 - OSS Endpoint 与 CDN 域名需解耦：CDN 回源指向 OSS 内网地址（如
oss-cn-hangzhou-internal.aliyuncs.com），避免公网带宽消耗
同步流程依赖 Redis 队列 + Golang 任务调度
官方开源的 aliyun/packagist-mirror 同步器不是简单 rsync，它把同步拆成三阶段：元数据抓取 → provider 分片生成 → ZIP 包下载上传。Redis 负责协调这些异步任务：
-
REDIS_DB: 0存储待处理的包名队列（如topthink/framework） - 每个 provider 分片（如
provider-topthink~framework.json）生成后，写入 OSS 并更新packages.json中对应providers-url字段 - Golang 进程监听 Redis，拉取任务后调用 GitHub API 获取 tag 列表，再并发下载 ZIP 并上传至 OSS 指定路径
若跳过 Redis 直接跑脚本，会丢失分片依赖关系，导致 p2/ 下 provider 文件缺失，composer install 报 Could not find package。
dist URL 必须与 OSS 实际路径严格对齐
Composer 客户端不关心你用什么技术栈，只认 packages.json 里写的 dist.url。这个 URL 最终要能拼出可访问的 ZIP 地址，例如：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
"dist": {
"url": "https://mirrors.aliyun.com/composer/dists/topthink/framework/8.0.0.zip",
"shasum": "a1b2c3..."
}
但注意：这个 https://mirrors.aliyun.com/composer/dists/... 必须实际回源到 OSS 对应 Object，比如 oss://my-mirror-bucket/dists/topthink/framework/8.0.0.zip。常见错误包括：
- OSS Bucket 未绑定自定义域名，却在配置里写
MIRROR_URL: https://my-mirror.example.com，导致 URL 404 -
DIST_URL配置漏掉/dists/路径前缀，结果生成https://my-mirror.example.com/topthink/...，OSS 找不到对象 - ZIP 包上传时未保留原始大小写（如把
TopThink写成topthink），而 Composer 解析 vendor 名是大小写敏感的
本地调试时绕过 CDN 直连 OSS 更可靠
开发自建镜像时，别急着配 CDN。先用 curl -I 直连 OSS 外网 Endpoint 验证路径是否通：
curl -I https://my-mirror-bucket.oss-cn-hangzhou.aliyuncs.com/dists/topthink/framework/8.0.0.zip
如果返回 HTTP/1.1 200 OK，说明 OSS 层已就绪；再把 MIRROR_URL 改成这个 OSS 地址，跑 composer install --repository=https://my-mirror-bucket.oss-cn-hangzhou.aliyuncs.com 测试端到端链路。CDN 层的缓存、HTTPS 证书、CORS 等问题，都该在 OSS 验证通过后再引入。
真正容易被忽略的是 OSS 的 Content-Type：ZIP 包必须设为 application/zip，否则某些 PHP curl 封装会拒绝解析。上传时加 --content-type application/zip 参数，别依赖自动识别。
