首页 / 开发手册 / 数据库

数据库

表结构、扩展字段的存法、索引表,以及怎么装到 MySQL / 从 SQLite 搬过去。

主要数据表

表存什么
contents内容主表,自定义字段值在扩展字段里
content_models内容模型与字段定义
content_field_index可筛选字段的索引
content_media图集
content_relations内容之间的关联
content_categories副栏目归属
categories栏目
users / roles用户与角色权限
forms自定义表单定义
messages留言与表单提交记录
logs操作日志

扩展字段怎么存的

自定义字段的值以 JSON 存在 contents.ext_data 里。 好处是加字段不改结构;代价是按字段查询不方便 —— 这正是索引表存在的原因。

索引表的工作方式

保存内容
   ↓ 遍历该模型的字段定义
   ↓ 只挑 filter = 1 的字段
   ↓ 数字存进 num_value,其余存进 str_value
content_field_index

前台按字段查询时走 EXISTS 子查询命中这张表,因此: 数字之间是数值比较(9 < 100 成立),并且查询走索引而不是全表扫描。

删除内容时索引行会一并清理,不会残留。

换成 MySQL

SQLite 开箱即用,小站直接用它就够了。真需要 MySQL 时,两条路都支持。

一、全新安装就用 MySQL

cd /path/to/site/wwwroot
runuser -u 站点用户 -- php install.php --cli --db=mysql \
    --dbhost=127.0.0.1 --dbport=3306 \
    --dbuser=库账号 --dbpass=库密码 --dbname=库名 \
    --user=admin --pass=管理员密码

--dbname 可以留空,程序会随机生成一个(和 SQLite 的随机文件名同一个思路)。 所以不必事先建库 —— 但那个账号得有建库权限。

二、已经在用 SQLite,把数据搬过去

cd /path/to/site/wwwroot
runuser -u 站点用户 -- php install.php --cli --tomysql \
    --dbhost=127.0.0.1 --dbport=3306 \
    --dbuser=库账号 --dbpass=库密码 --dbname=库名

它会按顺序做四件事:先在目标库按程序自己的结构建表 → 把数据逐表逐行搬过去 → 核对行数 → 最后才改 config.php。几点值得先知道:

  • 目标库必须是空的。程序不往一张已经有表的库里搬,免得覆盖别人的数据。
  • 搬的过程中站点照常可用,原来的 SQLite 文件一个字节都不动。 搬完想退回去,把 config.php 里的 driver 改回 sqlite 即可。
  • 任何一步不对,它会把配置还原、把刚建的表清掉,并如实说清哪一步错了。 站点不受影响,改完可以原样重跑。
  • 它会自己备份 config.php(同目录下的 config.php.bak_日期时间), 而且只改数据库那一段 —— 站点密钥、路径这些设置原样保留,不会被重置。
搬家挑站点闲的时候做。命令先取一个数据快照再搬,这期间新写进来的数据它会在下一轮补上; 但要是站点一直在写、补了几轮还追不上,它会停下来让你先停掉写入再跑 —— 不会带着一份"少了两行"的数据就切过去。
MySQL 下有两处 SQLite 没有的硬约束,程序已经统一处理掉了(见 core/Sql.php): 参与索引的 TEXT 列要降成长度 191 的 VARCHAR, 带非空默认值的 TEXT 列要改成短类型或去掉默认值。 你自己写插件时,建表与加列都走 Db::q() / Migrate::addColumn() 就行,不必自己操心方言。
备份要连 WAL 一起备份。SQLite 开启 WAL 模式后会额外生成 -wal 与 -shm 文件, 只复制 .db 一个文件可能丢掉最近的写入。系统的备份功能已经处理了这一点。
没找到答案? 可以在 联系我们 留言说明使用场景,我们会补充进文档。