答案:老旧包未提交至Packagist,故国内镜像无法同步;验证方式为curl -I https://packagist.org/p/oldvendor/oldlib.json返回404;应使用path类型仓库手动补composer.json并配置"files"自动加载。

不是镜像没同步,而是你正在查的包根本没进 Packagist —— 国内镜像只缓存已发布、合规、有 composer.json 的包,老旧库(如 Zend Framework 1.x、phpseclib 0.x)压根没提交过,镜像自然没有。
curl -I 验证包是否真实存在于 Packagist
这是最直接的判断方式。运行:
curl -I https://packagist.org/p/oldvendor/oldlib.json
如果返回 HTTP/2 404,说明官方源里都没有,换任何镜像都无效。别浪费时间调镜像配置或清缓存——问题不在网络,而在生态缺失。
项目级 repositories 配置会完全屏蔽全局镜像
即使你执行了 composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/,只要项目根目录 composer.json 里写了 "repositories" 字段(哪怕只是空数组),Composer 就会忽略全局设置,直接 fallback 到 https://packagist.org 或你写的自定义源。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 检查命令:
composer config --list | grep repositories,有输出就说明项目自己管源 - 临时绕过项目配置验证镜像:
composer show -d repo.packagist=composer monolog/monolog - 若项目必须保留私有源,可在
repositories数组里显式加入国内镜像条目,type 设为composer,URL 末尾带/
元数据缓存未刷新导致“新包查不到”
刚发布的包在镜像站通常有 5–30 分钟同步延迟。此时 composer require 报 Package not found 是正常现象,不是配置错误。
- 验证镜像是否已同步:
curl -I https://mirrors.tuna.tsinghua.edu.cn/composer/p/monolog/monolog.json,看Last-Modified时间是否接近当前时间 -
composer clear-cache不清元数据缓存,真正有效的是删目录:rm -rf ~/.composer/cache/repo/https---mirrors.tuna.tsinghua.edu.cn-composer - 别信
composer diagnose显示的 “Repo packagist.org: …” 行 —— 它只反映配置,不反映实际请求路径;要用composer require -vvv看第一行Downloading https://...的域名
老旧包必须手动补 composer.json + path 仓库
对于从未上 Packagist 的老库(比如只有 DB.php 和 MySQL.php 的 DB_MySQL),唯一可靠路径是本地化管理:
- 把库文件放到项目子目录,例如
./lib/legacy-db/ - 在该目录下新建最小
composer.json,关键字段只有name、version和autoload.files - 在项目根
composer.json的repositories里加一条:{"type":"path","url":"./lib/legacy-db"} - 运行
composer require legacy/db:1.0.0,再跑一次composer dump-autoload - 绝对不要用
psr-4或psr-0映射——老代码类名与文件路径不匹配 PSR 规范,只会报Class not found
容易被忽略的一点:autoload.files 是每次 dump-autoload 时无条件 require_once 的,它不依赖命名空间,也不走自动加载机制——这恰恰是兼容无命名空间老代码的唯一安全方式。










