composer中文元数据不来自packagist.org，因其不支持中文字段索引；企业需通过私有仓库（如satis）保留utf-8编码的原始composer.json，并扩展zh_description等自定义字段，再经nlp解析构建neo4j知识图谱。
Composer 中文元数据从哪来？别指望 packagist.org
Composer 官方仓库 packagist.org 不支持中文字段（name、description、keywords 等）的索引与搜索，所有中文内容在默认配置下会被忽略或截断。企业内部类库若想用中文描述构建知识图谱，必须绕过 Packagist，改用私有仓库 + 自定义元数据注入机制。
常见错误是直接在 composer.json 里写中文 description，然后跑 composer search —— 结果为空或乱码，因为 Composer CLI 默认只解析英文字段，且不触发中文分词。
- 私有仓库（如 Satis 或 Private Packagist）需启用
archive模式并导出完整composer.json原始内容，不能依赖 Packagist 的摘要缓存 - 中文字段必须保留在原始
composer.json中，且编码为 UTF-8（BOM 会导致解析失败） - 建议额外增加自定义字段，例如
"zh_description"、"zh_tags"，避免和官方字段语义冲突
如何提取并结构化中文元数据？用 json-schema + PHP 解析器
直接读取所有类库的 composer.json 文件只是第一步；关键是要把非结构化的中文文本（如 zh_description）转成可查询的实体-关系片段。不要手写正则匹配，用轻量级 NLP 工具链更可靠。
典型场景：某内部组件 corp/utils-auth 的 composer.json 包含："zh_description": "提供基于 JWT 的单点登录与权限校验，兼容 Laravel 和 ThinkPHP"。你需要从中抽取出「JWT」「单点登录」「权限校验」「Laravel」「ThinkPHP」等实体，并标注类型（技术名词 / 框架 / 功能）。
- 用
phpstan/extension-installer加载自定义解析器，避免修改 Composer 核心逻辑 - 中文分词推荐
overtrue/pinyin（用于拼音检索） +thans/pseg（轻量级词性标注，支持自定义词典） - 对
keywords和zh_tags字段做归一化：统一小写、去停用词、合并同义词（如「鉴权」→「权限校验」） - 注意
require和require-dev中的包名不是中文元数据，但它们构成依赖边，需单独建模
知识图谱存储选什么？别用 MySQL 存三元组
MySQL 或 PostgreSQL 可以存节点和边，但查“哪些类库同时用到了 Redis 和 OAuth2”这类多跳关联时性能骤降。企业级 PHP 类库图谱不是静态文档，需要支持模糊匹配、版本感知、上下文路径追踪。
实际落地建议：用 Neo4j（社区版足够）+ php-client 驱动，节点类型固定为 :Package、:Class、:Function、:Tag，关系类型包括 REQUIRES、IMPLEMENTS、MENTIONS（指向中文关键词节点）。
-
:Tag节点必须带lang: "zh"属性，区分中英文标签，避免「log」和「日志」被误认为同一概念 - 每个
:Package节点存version和dist-reference，支持按版本范围查询（例如 “v2.x 中用到 Guzzle 的组件”） - 避免把整个
composer.json当属性存进节点——只存关键字段，大文本走外部 ES 或 SQLite 存档
图谱怎么用起来？CLI 工具比 Web 界面更实用
内部开发者最常做的操作不是“浏览图谱”，而是“我这个项目用了 Laravel，有哪些类库能无缝集成？”或者“corp/log-center 升级到 v3 后，哪些下游项目要改？”——这些需求用 REST API + CLI 就够了，Web 界面反而增加维护成本。
示例命令：php bin/kb.php find --uses="jwt" --in="corp/*" --lang=zh，返回匹配的包名、中文描述片段、最近一次更新时间。
- CLI 必须支持 --dry-run 模式，先输出 Cypher 查询语句，方便 DBA 审计性能
- 结果里中文字段要原样返回（不转义），但需过滤掉控制字符（
\x00-\x08,\x0B\x0C,\x0E-\x1F） - 加一个
--explain参数，显示该查询命中了哪些索引、走了几跳、是否触发全文扫描 - 别忘了加
vendor/bin/kb.php到每个类库的scripts里，让开发者一键上报变更
最难的部分不是建图，而是让每个类库维护者习惯在发版前运行 composer kb:publish —— 这个动作得轻量、快、有明确反馈，否则三个月后图谱就只剩 skeleton 包。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
