Composer中文元数据指国内镜像缓存的、部分字段（如description、keywords）被翻译成中文的composer.json副本，name等核心字段仍为英文，不参与依赖解析；真实框架内核版本关系须调用Packagist官方API（如https://packagist.org/packages/laravel/framework.json）获取含require、conflict、replaces等字段的完整版本数据。
Composer 中文元数据到底指什么？
它不是 Composer 官方概念，而是国内镜像（如 https://packagist.phpcomposer.com 或已停用的阿里云镜像）曾缓存并本地化处理过的 composer.json 元数据副本。这些副本里部分字段（如 description、keywords）被翻译成中文，但 name、version、require 等核心字段仍为原始英文。真正影响框架内核版本关联的，只有原始 Packagist 的 JSON API 数据 —— 中文元数据本身不参与依赖解析、版本约束计算或 autoloading。
怎么从 Packagist 获取真实框架内核版本关系？
别依赖镜像的中文页面或缓存摘要，直接调用官方 API：
-
GET https://packagist.org/packages/laravel/framework.json返回完整版本列表、require、conflict、replaces等字段 -
GET https://packagist.org/packages/symfony/http-kernel.json同理，注意type字段是否为symfony-bundle或library - 每个
versions数组项含version、time、require（嵌套依赖）、autoload（PSR-4 映射），这才是构建关联图谱的真实依据
示例关键片段：
{"name": "laravel/framework", "versions": {"v10.48.12": {"version": "v10.48.12", "require": {"php": "^8.1", "symfony/http-kernel": "^6.2", "illuminate/contracts": "^10.0"}}}}
为什么不能只靠 composer show --tree 生成图谱？
这个命令只反映当前项目 lock 文件中已解析出的单一路径依赖树，会漏掉：
立即学习“PHP免费学习笔记（深入）”；
- 同一包不同版本对不同内核版本的兼容性（比如
doctrine/dbalv3 支持 Laravel 9/10，但 v2 只支持到 Laravel 8） - 冲突约束（
conflict字段声明的互斥版本，composer show不显示） - 替换关系（
replaces如psr/log被monolog/monolog替换，影响内核日志组件选型） - PHP 版本硬性门槛（
"php": "^8.1"出现在require中，但composer show不校验当前环境 PHP 是否达标）
图谱构建时最容易忽略的三个硬约束
实际写脚本拉取和解析 Packagist 数据时，必须显式检查：
-
minimum-stability：默认stable，但有些框架内核（如spatie/laravel-ray）主干长期在dev-main，需主动加&include=dev-main参数 -
require-dev字段干扰：它描述开发期依赖（如phpunit/phpunit），不应混入运行时内核关联图谱；解析时要严格过滤掉 - 版本号语义歧义：
v8.0.0和8.0.0在 Packagist 数据中可能同时存在，但 Composer 解析器按^8.0规则统一归一化；图谱节点应以规范化的8.0.0为准，而非原始字符串
没有统一清洗这三项，图谱里会出现虚假分支或断裂链路 —— 比如把 laravel/framework v9.x 和 symfony/console v5.x 标记为可共存，实际因 conflict 字段被阻断。
