附录 B：Z-BlogPHP 核心模板标签速查字典

模板引擎（Template Engine）是连接底层关系型数据库（MySQL）与前端视图（HTML）的核心枢纽。Z-BlogPHP 提供了一套高度封装且极具语义化的标签系统，允许前端工程师在无需深度精通 PHP 底层算法的前提下，实现复杂业务数据的动态读取与渲染。

本速查字典按架构层级汇总了高频使用的核心标签，供全栈开发阶段查阅。

一、全局环境变量与基础配置

此类变量贯穿系统的整个运行生命周期，通常用于 <head> 元数据挂载或全局公共视图的渲染。

模板标签	数据类型	架构含义与工程应用场景	示例输出
`{$host}`	String	系统根路由（绝对路径）。用于静态资产（CSS/JS/图片）的寻址，彻底杜绝相对路径带来的 404 错误。	`http://blog.test/`
`{$name}`	String	系统全局名称。用于映射网站的品牌名称，常用于 `<title>` 标签或 Logo 区域。	`我的前端工程博客`
`{$subname}`	String	系统副标题（Slogan）。用于呈现网站的业务标语或核心定位。	`记录全栈开发的每一天`
`{$theme}`	String	当前激活的主题 ID。用于动态拼接主题的物理目录路径。	`yt_engineering`
`{$style}`	String	当前激活的主题样式 ID。用于精确挂载对应的 CSS 渲染流。	`default`
`{$version}`	String	CMS 引擎核心版本号。常拼接在 JS 库路径后，用于强制刷新浏览器缓存。	`172024`
`{$copyright}`	String	全局版权声明。用于 `footer.php` 映射后台配置的 IPC 备案或版权年份。	`© 2026 某某科技`

此类指令用于执行视图层的“物理切片”重组与外围组件（Widget）的召回。

模板标签	引擎动作	工程应用场景
`{template:文件名}`	视图拼装（Include）	核心装配指令。用于将独立的微视图（如 `header`、`footer`）动态注入当前上下文。注意：无须书写 `.php` 后缀。
`{module:模块ID}`	组件召回（Widget）	挂载后台“模块管理”中定义的功能块（如 `navbar` 全局导航、`comments` 最新评论矩阵）。

此类语法赋予了静态视图逻辑判断与数据遍历的能力。

语法结构	逻辑范式	工程应用场景
`{if 条件} ... {else} ... {/if}`	状态机分支（If/Else）	路由拦截与多态分发。例如：判断 `$type=='index'` 来决定渲染首页架构还是列表架构；或判断 `$article.Type` 区分单页与文章。
`{foreach $数组 as $变量} ... {/foreach}`	迭代渲染（Loop）	集合遍历引擎。例如：遍历 `$articles` 数组，动态生成新闻列表的 `<li>` 矩阵。极大地践行了 DRY 原则。

在 single.php 或 {foreach} 循环体内，$article 是最核心的数据对象上下文（Context），承载了单篇资讯的所有多维元数据。

属性调用	数据类型	架构含义与工程应用场景
`{$article.ID}`	Integer	业务主键（Primary Key）。数据库中该文章的绝对唯一标识。
`{$article.Title}`	String	业务标题。文章的主标题，常映射于 `<h1>` 或 `<h2>` 节点。
`{$article.Url}`	String	统一资源定位符。该文章的独立前端路由访问地址，常绑定于 `<a>` 标签的 `href` 属性。
`{$article.Content}`	HTML	富文本渲染流。后台编辑器生成的 HTML 业务正文载荷。
`{$article.Intro}`	HTML	业务摘要。文章的简短引言，常用于列表页的卡片数据填充。
`{$article.ViewNums}`	Integer	热度探针（PV）。该文章的累计浏览次数。
`{$article.CommNums}`	Integer	互动探针。该文章的累计评论条数。
`{$article.Author.StaticName}`	String	鉴权实体关联。该文章原作者的公开显示昵称。
`{$article.Category.Name}`	String	拓扑分类关联。该文章所属的业务板块或分类名称。
`{$article.Time('Y-m-d')}`	String	时间戳格式化。输出该文章的发布时间，括号内为标准 PHP 时间格式化参数（如输出 `2026-03-24`）。

为了保障前端工程的高可扩展性（Extensibility），必须在视图边界预留插件挂载点。

钩子标签	触发时机	架构约束与应用场景
`{$header}`	渲染前置（DOM Ready 前）	必须严格放置在 `</head>` 闭合标签之前。允许第三方 SEO 插件、鉴权模块在此处动态注入 `<meta>` 或同步拦截脚本。
`{$footer}`	渲染收官（DOM 闭合前）	必须严格放置在 `</body>` 闭合标签之前。用于挂载流量统计脚本（如百度统计、Google Analytics）或弹窗插件，确保不阻塞首屏渲染。