PHP实现数据血缘图谱_自动生成数据字典文档【教程】-php教程-PHP中文网

php从mysql提取表结构生成数据字典应直接查information_schema，用pdo预处理查询tables与columns视图，必选字段含column_comment和ordinal_position排序，防注入并兼容mysql 5.7+外键元数据缺陷。

php实现数据血缘图谱_自动生成数据字典文档【教程】

PHP如何从MySQL提取表结构生成数据字典

直接读 INFORMATION_SCHEMA 是最稳的路，不用依赖ORM或额外扩展。PHP 8+ 建议用 PDO，避免 mysql_*（已废弃）和 mysqli::fetch_all（部分旧版本不支持 MYSQLI_NUM 以外模式）。

关键字段要捞全：TABLE_NAME、COLUMN_NAME、DATA_TYPE、IS_NULLABLE、COLUMN_DEFAULT、COLUMN_COMMENT，尤其别漏 COLUMN_COMMENT——很多团队靠它写业务含义，是血缘图谱里“语义层”的起点。

SELECT 
  t.TABLE_NAME,
  c.COLUMN_NAME,
  c.DATA_TYPE,
  c.IS_NULLABLE,
  c.COLUMN_DEFAULT,
  c.COLUMN_COMMENT
FROM INFORMATION_SCHEMA.TABLES t
JOIN INFORMATION_SCHEMA.COLUMNS c ON t.TABLE_SCHEMA = c.TABLE_SCHEMA AND t.TABLE_NAME = c.TABLE_NAME
WHERE t.TABLE_SCHEMA = ? AND t.TABLE_TYPE = 'BASE TABLE'
ORDER BY t.TABLE_NAME, c.ORDINAL_POSITION

参数用 ? 占位 + bindValue，防库名注入（哪怕库名来自配置）
注意 ORDINAL_POSITION 排序，否则字段顺序可能错乱，影响文档可读性
如果用 MySQL 5.7+，COLUMN_COMMENT 支持 1024 字符，但 PHP mb_strlen 仍建议校验，超长时截断并加 … 标识

用PHP解析SQL建表语句反推字段依赖（绕过权限限制场景）

有些生产环境禁止查 INFORMATION_SCHEMA，或只开放只读账号且没授该库权限。这时得退回到 SQL DDL 文件——但别手写正则硬匹配 CREATE TABLE，容易被注释、换行、引号嵌套搞崩。

推荐用轻量解析器：GitHub 上的 sql-parser（小而专，无 Laravel 依赖），或自己写状态机处理 CREATE TABLE → ENGINE= 之间的块。重点抓三类依赖线索：

FOREIGN KEY 子句里的 REFERENCES，提取目标表+字段，构成血缘边
COMMENT 后单引号/双引号内的内容，作为字段级描述（注意转义：\’ 要还原为 ’）
DEFAULT CURRENT_TIMESTAMP 这类隐式逻辑，虽不产血缘，但影响数据可信度，在字典中标记为「系统生成」

别碰 VIEW 或存储过程里的 SQL——动态拼接、变量替换会让静态解析失效，这类必须人工补录。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

生成Mermaid格式血缘图时PHP怎么组织节点与边

Mermaid 的 erDiagram 或 graph LR 都能画血缘，但 erDiagram 对字段级关系更友好。PHP 不需要实时渲染，只需拼出合法文本。核心约束有两个：

表名、字段名含空格或特殊符号（如 user_info_v2）必须用双引号包裹，否则 Mermaid 解析失败
一条边只能连接两个字段；如果 A 表的 org_id 同时引用 B 表和 C 表的 id，就得拆成两条边："A::org_id" --> "B::id" 和 "A::org_id" --> "C::id"
避免重复边：用 ["A::x", "B::y"] 组成键，存进 array_unique 前先 sort 两端，防止 A→B 和 B→A 被当成不同边

示例片段：

erDiagram
    "users" {
        string "id" PK
        string "name" ""
        int "dept_id" ""
    }
    "departments" {
        int "id" PK
        string "name" ""
    }
    "users" ||--o| "departments" : "dept_id"

为什么生成的字典文档里外键没显示关联表字段名

因为 MySQL 的 KEY_COLUMN_USAGE 视图里，REFERENCED_COLUMN_NAME 在某些版本（如 5.6）返回 NULL，即使建表时写了 REFERENCES departments(id)。这不是 PHP 的锅，是 MySQL 元数据填充缺陷。

解法只有两个：

升级到 MySQL 5.7+ 并确认 innodb_stats_persistent 开启（影响统计信息完整性）
降级处理：当 REFERENCED_COLUMN_NAME 为空时，查目标表的主键字段（SELECT COLUMN_NAME FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE WHERE TABLE_SCHEMA=? AND TABLE_NAME=? AND CONSTRAINT_NAME='PRIMARY'），默认关联主键

这个坑常被忽略——表面看外键关系存在，实际血缘图里连不到具体字段，导致下游分析误判数据流向。