模板主题包与模板层能力

这一页说明模板主题包的构成和切换流程。主题包是模板文件与元信息的集合,放在 themes/<标识>/ 下,与后台内容表相互独立:后台负责数据,主题包负责页面结构。

已具备的能力

后台「模板主题」模块可以查看主题包列表、theme.json 元信息与模板文件清单,按当前编辑站点切换主题,以及启用 / 停用非内置主题。主题目录由全局中间件在前台请求里注入,后台模板目录不受影响。

主题包清单

  • 默认主题 标识 default 版本 1.0.0 模板文件 12 个 启用(当前站点使用中)
  • 紧凑版示例 标识 compact 版本 1.0.0 模板文件 12 个 启用

当前站点绑定的主题:默认主题。

theme.json 与模板文件清单

每个主题包根目录有一份 theme.json,记录标识、名称、说明、版本与模板相对路径列表。它只用于展示,不参与渲染逻辑,避免把配置做成第二个数据库。模板文件统一放在 themes/<标识>/view/,保持与 ThinkPHP 原生视图目录相同的相对结构。

切换流程与缓存

一、在后台选定当前编辑站点;二、进入「模板主题」选择已启用的主题并提交切换;三、切换动作把该站点的 theme_id 写入站点表,并清空全部静态缓存;四、执行 php think static:build 重新预热,静态页按站点与主题分别落盘。

静态缓存命中时会直接返回磁盘上的 HTML,根本不会渲染模板,因此缓存键里带上了主题标识;切换后旧主题的缓存文件不会残留,前台也不会命中旧模板。

边界

主题包需要先由设计稿适配成模板文件,系统不提供一键导入任意 HTML、不提供在线编辑模板文件、也不提供可视化拖拽建站。切换是低频的交付配置动作,实际切换由超管在后台执行,演示账号保持只读。