数据库
表结构、扩展字段的存法、索引表,以及怎么装到 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 一个文件可能丢掉最近的写入。系统的备份功能已经处理了这一点。
