Typecho 数据库设计

Typecho 是一个轻量级的 PHP 博客系统，其数据库设计简洁而强大。本文详细介绍 Typecho 的数据库表结构，方便开发者进行二次开发和主题定制。

设计理念

Typecho 的数据库设计遵循"精简而灵活"的原则：

• 内容与项目抽象分离 - 通过关系表实现内容与分类/标签的多对多映射
• 单表多用 - typecho_contents 表同时存储文章、页面、草稿、附件等多种内容类型
• 最小冗余 - 仅在必要时（如 commentsNum）使用冗余字段提升查询性能
• 灵活扩展 - 通过 typecho_fields 表支持主题自定义字段

数据库表概览

Typecho 1.2.1 使用 7 张核心表：

1. typecho_contents（内容表）

核心表，存储所有内容数据（文章、页面、草稿、附件等）。

字段说明

type 字段详解

• post - 文章
• page - 独立页面
• attachment - 附件（上传的文件）
• draft - 草稿

text 字段说明

• Typecho 使用 <!--markdown--> 标记区分 Markdown 和 HTML 内容
• 正文内容直接存储在此字段中

索引策略

• slug 字段有唯一索引，确保 URL 不重复
• created 字段有索引，加速按时间排序查询

2. typecho_metas（项目表）

存储分类和标签数据，支持分类层级。

字段说明

type 字段详解

• category - 分类（支持多级，通过 parent 字段实现）
• tag - 标签（扁平结构，parent 始终为 0）

分类层级示例

技术 (mid=2, parent=0)
  └── 嵌入式软件 (mid=12, parent=2)

索引策略

• slug 字段有唯一索引

3. typecho_relationships（关系表）

实现内容与分类/标签的多对多映射。

字段说明

设计说明

• 使用 (cid, mid) 联合主键，防止重复关联
• 一篇文章可以属于多个分类和多个标签
• 查询文章的分类：SELECT * FROM typecho_metas WHERE mid IN (SELECT mid FROM typecho_relationships WHERE cid=42)

示例数据

[3, 2]   // 文章3 → 分类"技术"
[3, 4]   // 文章3 → 标签"markdown"
[45, 2]  // 文章45 → 分类"技术"
[45, 13] // 文章45 → 标签"programming"

4. typecho_comments（评论表）

存储评论数据，支持嵌套评论。

字段说明

嵌套评论示例

评论1 (coid=1, parent=0)
  └── 回复1-1 (coid=2, parent=1)
  └── 回复1-2 (coid=3, parent=1)
评论2 (coid=4, parent=0)

索引策略

• cid 字段有索引，加速按文章查询评论

5. typecho_users（用户表）

存储博客用户账户信息。

字段说明

group 字段详解

• administrator - 管理员（完全权限）
• editor - 编辑（可发布文章）
• contributor - 投稿者（提交草稿）
• subscriber - 订阅者（仅评论）
• visitor - 游客（仅浏览）

密码加密

Typecho 使用 phpass 算法（$P$ 前缀）加密密码，不可逆。

6. typecho_options（配置表）

存储系统配置和用户偏好设置，支持用户级配置。

字段说明

配置示例

["theme", 0, "MWordStar"]       // 全局主题
["timezone", 0, "28800"]        // 时区（东八区）
["siteUrl", 0, "https://961118.xyz"]  // 网站地址
["title", 0, "我的博客"]         // 网站标题

设计说明

• (name, user) 联合主键，支持全局配置和用户配置
• user=0 表示全局配置
• user>0 表示特定用户的配置

7. typecho_fields（自定义字段表）

主题扩展表，用于存储文章自定义字段（主题相关设置）。

字段说明

常见字段（MWordStar 主题）

设计说明

• (cid, name) 联合主键，一篇文章可以有多个自定义字段
• 使用三列存储（str_value / int_value / float_value），根据 type 决定使用哪一列
• 主题可以自由定义字段，不需要修改数据库结构

数据库关系图

typecho_users (uid)
    ↓
typecho_contents (cid, authorId)
    ↓                    ↓
typecho_comments    typecho_fields
    ↓
typecho_relationships (cid, mid)
    ↓
typecho_metas (mid)

参考资料

• Typecho 官方文档 - 数据库设计
• Typecho GitHub 仓库
• Typecho 插件开发文档