详解Composer镜像源同步的元数据处理-composer-PHP中文网

composer 配置镜像必须带末尾斜杠，否则路径拼接错误导致静默回退；元数据缓存硬编码15分钟，仅composer update --refresh可精准刷新，手动清缓存无效。

详解composer镜像源同步的元数据处理

composer config --global repo.packagist 必须带末尾斜杠

不加 / 会导致 Composer 拼接出错路径，比如把 https://mirrors.aliyun.com/composer 和 packages.json 连成 https://mirrors.aliyun.com/composerpackages.json，直接 404。此时 Composer 不报错，而是静默 fallback 到 repo.packagist.org，你根本不知道自己没走镜像。

正确写法只有一种：composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/（注意结尾的 /）。

验证是否生效：运行 composer config --global repo.packagist，输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
composer diagnose 显示 “Repo packagist.org is default” 就说明配置失败
项目级 composer.json 中若存在 "repositories" 字段，会彻底屏蔽该全局配置，哪怕 URL 正确也无效

元数据缓存硬编码为15分钟，不可调也不可绕过

Composer 客户端对 packages.json 和所有 provider-*.json 的缓存策略是硬编码的：15 分钟内绝不重发 HTTP 请求。这不是 bug，是设计——它不管镜像站是否已同步，只看本地文件时间戳。

所以你看到“阿里云说已同步”，但 composer update 仍装不到新版本，大概率只是因为本地缓存还没过期。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

composer clear-cache 对元数据完全无效，它只删 ZIP 包和部分临时 JSON
没有 --cache-ttl 或 cache-interval 这类配置项，所有“调刷新频率”的尝试都是徒劳
真实缓存路径在 $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer/ 下，packages.json 和 provider-*.json 都在这里

composer update --refresh 是唯一可靠元数据刷新手段

composer update --refresh（仅 Composer ≥ 2.5 支持）是目前最轻量、最精准的元数据刷新方式：它只删除 repo/ 子目录下的 packages.json 和全部 provider-*.json，强制从当前生效镜像源重拉索引，但保留已下载的 ZIP 包缓存。

它不解决镜像站本身未同步的问题，但它能确保你本地拿到的是“镜像站此刻能给的最新元数据”。

执行前务必确认 composer config --global repo.packagist 输出是你期望的地址
若项目 composer.json 含 "repositories"，需改用 composer config repo.packagist（不带 -g）查项目级配置
老版本（≤2.4）只能手动清理：rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer
加 --no-cache -vvv 可在终端日志里确认请求 URL 是否命中你的镜像域名

镜像不是代理，元数据一致性需逐文件校验

国内镜像不是反向代理，而是对 Packagist 元数据的全量定时同步。这意味着 packages.json 更新了，不代表 p2/laravel/framework/10.0.0.json 也同步了——它们是独立文件，由不同任务触发拉取。

所谓“同步不及时”，往往是你依赖的那个 provider-*.json 文件还没生成或没推送到边缘节点。

验证某包是否可用：用 curl -I https://mirrors.aliyun.com/composer/p2/vendor/package/1.2.3.json 看是否返回 200，而非只测 packages.json
比对版本列表是否一致：curl -s https://packagist.org/p2/vendor/package.json | jq -r '.packages."vendor/package" | keys[]' | sort 和镜像站同命令结果逐行比对
响应头中的 Last-Modified 滞后超过 180 秒，或 Age 值过大（如 Age: 1800），说明你命中的 CDN 节点缓存严重滞后
别信镜像首页显示的“最后同步时间”，那是主节点时间，不反映你实际访问到的边缘节点状态