ThinkPHP模板包含与渲染用法详解

一、模板包含（Include）基础

在ThinkPHP视图模板中，使用<include>标签可以引入其他模板文件，实现代码复用。该标签支持多种路径引用方式和参数传递。

第1步：标准模板引用

目的：引入指定目录下的完整模板文件。
动作：使用<include file="..." />语法。

• 相对路径引用：<include file="./Tpl/default/Public/header.html" /> 明确指向Public文件夹下的header模板。
• 同级目录引用：<include file="read" /> 调用当前模板同级目录下的read.html文件。
• 命名空间引用：<include file="Public:header" /> 引入Public模块或名称空间下的header模板。

第2步：多层级与动态引用

目的：处理复杂目录结构或动态变量引用的场景。
动作：根据实际项目结构调整file属性值。

• 多级嵌套引用：<include file="blue:User:read" /> 适用于具有深层模块层级（如Blue模块User控制器下的read视图）的情况。
• 动态变量引用：<include file="$tplName" /> 允许通过控制器分配给视图的变量动态决定加载哪个模板。

第3步：多文件包含与参数传递

目的：一次性引入多个公共模块并传递自定义变量。
动作：逗号分隔文件名，并在标签内定义属性作为模板变量。

<!-- 同时引入file1和file2 -->
<include file='file1,file2' />

<!-- 传递参数到被引入的模板 -->
<include file="header" title="ThinkPHP框架" keywords="开源WEB开发框架" />

注意：在模板中若需接收变量，通常依赖ThinkPHP的变量替换机制（视版本而定，新版更推荐直接在模板中使用{$title}等TP标准变量语法，而非旧版的[变量]形式，具体需参考所用TP版本的文档规范。）

二、模板渲染（Layout）机制

模板渲染用于将各个具体的业务模板嵌入到一个统一的“外壳”模板中，从而保持网站整体风格一致。ThinkPHP提供了自动开启和手动触发两种方式。

第4步：配置自动开启全局渲染

目的：在项目配置文件中启用布局功能，所有未禁用布局的模板自动套用统一的外壳。
入口：应用配置文件（如 Config.php 或 common.php）。
动作：设置LAYOUT_ON为true。

'LAYOUT_ON' => true, // 开启模板渲染/布局功能

准备工作：在Public（或类似公共目录）下创建一个布局模板文件（如 layout.html）。在该文件中，使用特殊标签{__CONTENT__}作为占位符，此处将填充具体的业务模板内容。

第5步：排除特定模板的渲染

目的：在某些特定页面（如Ajax返回、独立弹窗页）不需要套用水果层布局。
动作：在具体模板文件的头部添加{__NOCONTENT__}。

一旦加入此标记，即使开启了LAYOUT_ON，该模板也不会被嵌入布局文件，而是直接输出自身内容。

第6步：手动开启局部渲染

目的：在不全局开启LAYOUT_ON的情况下，仅在个别页面应用布局。
动作：在具体模板页面的页首添加<layout>标签。

<layout name='layout'/>

说明：上述代码表示当前页面将使用名为layout的布局模板进行渲染。默认情况下，ThinkPHP会在公共模板目录下查找对应的布局文件。

三、总结

通过合理使用include标签，可以实现页面组件的模块化拆分，提高代码维护性；而通过layout布局功能，则能有效统一管理网站的头尾结构和CSS/JS资源引用。开发者可根据项目规模选择全局开启或按需开启布局功能，以提升开发效率并保持前端代码整洁。 以上就是ThinkPHP模板包含与渲染详细内容的完整介绍，更多关于ThinkPHP模板开发的资料请关注本站其它相关文章！