ThinkPHP数据字典怎么建_ThinkPHP元数据管理方法【技巧】-ThinkPHP-PHP中文网

db::gettables() 不带表注释，需用 show table status 或 information_schema.tables；show columns 缺失 column_comment 等关键字段信息，推荐用 information_schema.columns 查全元数据，并注意字符集、null 判定及 ordinal_position 排序。

thinkphp数据字典怎么建_thinkphp元数据管理方法【技巧】

Db::getTables() 能拿到表名，但不带注释；SHOW TABLE STATUS 和 information_schema.TABLES 才能查到表级注释——这是绝大多数人卡住的第一步。

为什么直接用 `Db::query('SHOW COLUMNS FROM xxx')` 不够用

它只返回字段基础定义（Field、Type、Null等），但缺失关键业务信息：COLUMN_COMMENT 字段注释、字符集、是否为生成列、默认值表达式（如 CURRENT_TIMESTAMP）都不在结果里。
更麻烦的是，ThinkPHP 5.1+ 的 Db::query() 默认不返回关联索引，fetch_assoc 行为需手动处理，否则遍历时容易漏字段或键名错位。

用 `information_schema` 查全字段元数据（推荐）

MySQL 的 information_schema.COLUMNS 是最稳定、最完整的字段元数据源，尤其适合生成正式数据字典。注意三点：

TABLE_SCHEMA 必须显式指定，不能依赖当前连接库名，否则跨库查询会出错
COLUMN_DEFAULT 为 NULL 时，实际返回的是 NULL 值而非字符串 'NULL'，判空要用 is_null()，别用 == 'NULL'
COLUMN_TYPE 包含括号和长度（如 varchar(255)），解析枚举/集合类型时需正则提取，别直接当字符串截取

ThinkPHP 6 命令行生成 Markdown 字典的实操要点

自定义命令类里别硬拼 SQL 字符串，尤其是表名带前缀时。正确做法是用 Db::getConfig('prefix') 拿前缀，再用 str_replace() 剥离，避免 SHOW CREATE TABLE `pre_user` 这种写法被防火墙或安全插件拦截。

btpanel phpsite 宝塔面板PHP网站

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

下载

生成 Markdown 表格时，字段顺序建议按 ORDINAL_POSITION 排，不是按查询返回顺序——后者在某些 MySQL 版本中不稳定。示例片段：

$sql = "SELECT COLUMN_NAME, COLUMN_TYPE, IS_NULLABLE, COLUMN_DEFAULT, COLUMN_COMMENT, ORDINAL_POSITION
        FROM information_schema.COLUMNS 
        WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ?
        ORDER BY ORDINAL_POSITION";
$fields = Db::query($sql, [$dbName, $tableName]);

中文注释乱码？检查三处字符集配置

即使数据库用 utf8mb4，数据字典仍可能显示问号，问题通常不在 SQL 层：

PHP 连接参数没设 charset=utf8mb4（ThinkPHP 配置里 database.charset 必须显式声明）
MySQL 服务端的 collation_server 是 latin1_swedish_ci，导致 information_schema 元数据被转码
导出 HTML 时没写 <meta charset="utf-8">，浏览器按 ISO-8859-1 解析

最容易被忽略的是第二点：哪怕你的业务库全是 utf8mb4，只要 information_schema 自身的 collation 不匹配，COLUMN_COMMENT 就是乱码——这个坑在阿里云 RDS 和腾讯云 CVM 上高频出现。