老旧 PHP 库未提交至 Packagist，故国内镜像无法同步；验证方式为 curl -I https://packagist.org/p/oldvendor/oldlib.json 返回 404；应使用 path 类型仓库手动补 composer.json 并通过 "files" 自动加载。
国内镜像查不到老旧包，不是镜像问题，是它压根没同步
阿里云、腾讯云等国内镜像只同步 Packagist.org 上**已发布且通过合规检查**的包，而大量老旧 PHP 库（如 2010–2015 年间发布的 DB_MySQL、phpseclib 0.x、Zend Framework 1.x 等）从未提交到 Packagist，也没有 composer.json，镜像自然不会收录——你换再快的镜像也查不到一个根本不存在的包名。
验证方法很简单：curl -I https://packagist.org/p/oldvendor/oldlib.json 返回 404，就说明 Packagist 官方源里都没有，镜像不可能有。
- 别试
composer clear-cache：它清不掉“根本没存在过”的事实 - 别改
repo.packagist配置：指向哪儿都一样，源里没数据 - 别信“镜像全量代理”：镜像只缓存 Composer 可识别的合法包元数据，不是文件托管服务
老旧库没上 Packagist，就得手动告诉 Composer “它在这儿”
最稳妥的路径是用 path 类型仓库 + 手动补 composer.json，绕过 Packagist 元数据依赖。前提是这个库你已经下载或拷贝到了本地目录（比如 ./lib/legacy-db）。
在项目根目录 composer.json 的 repositories 数组里加一条：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"type": "path",
"url": "./lib/legacy-db"
}
然后在 ./lib/legacy-db/composer.json 里写一个最小可用配置（哪怕原库根本没有）：
{
"name": "legacy/db",
"version": "1.0.0",
"autoload": {
"files": ["DB.php", "MySQL.php"]
}
}
-
"files"是关键：它让 Composer 在每次dump-autoload时无条件require_once这些文件，适合无命名空间、无类自动映射的老代码 - 不要用
"psr-0"或"psr-4"：老库的类名和文件路径几乎肯定不匹配 PSR 规范，强行套用只会类找不到 - 运行
composer require legacy/db:1.0.0后，必须再跑一次composer dump-autoload才生效
require 时加 --stability=dev 不是万能解，反而可能掩盖真实问题
看到 Package not found 就下意识加 --stability=dev，容易误判。老旧包的问题通常不是“版本不稳定”，而是“根本没进 Composer 生态”。加了这个参数后依然报错，基本可以排除稳定性设置问题。
-
composer search oldlib能搜到 ≠composer require oldlib能装：search 查的是 Packagist 全量索引（含已废弃包），require 却只认当前生效源里可解析的元数据 - 如果
composer show oldvendor/oldlib直接报错，且curl https://packagist.org/p/oldvendor/oldlib.json404，那就不用再调 stability 参数了 - 某些旧版 Composer（--stability 解析有 bug，升级到
2.9.6再试，避免被误导
私有 Git 仓库里的老旧包，vcs 源配了也不行？检查三件事
你把老库推到了公司 GitLab，并在 repositories 里写了 "type": "vcs"，但 composer require myorg/oldlib 仍失败——大概率卡在元数据生成环节。
- 仓库根目录必须有
composer.json，且"name"字段格式为vendor/package（全小写，斜杠为英文），不能是myorg-oldlib或OldLib - Git 仓库必须有至少一个可用的 tag（如
v1.0.0）或稳定分支（如main、master），否则 Composer 无法确定版本号 - 运行
git ls-remote --tags https://gitlab.example.com/myorg/oldlib.git确认 tag 可见；若需认证，得配好auth.json，否则Could not fetch是静默失败，不是网络问题
真正容易被忽略的是：Composer 2.9.6 对老旧 Git 仓库的 ref 分析更严格，如果 composer.json 里写了 "minimum-stability": "dev" 但没打任何 tag，它会直接跳过该仓库，连尝试都不做。
