thinkphp常用内置标签include的详解

PHP中文网

发布时间：2017-03-30 16:07:57

2917人浏览过

来源于php中文网

原创

变量输出使用普通标签就足够了，但是要完成其他的控制、循环和判断功能，就需要借助模板引擎的标签库功能了，系统内置标签库的所有标签无需引入标签库即可直接使用。

XML标签有两种，包括闭合标签和开放标签，一个标签在定义的时候就已经决定了是否是闭合标签还是开放标签，不可混合使用，例如：

闭合标签：

<include file="read" />

开放标签：

<gt name="name" value="5">value</gt>

内置支持的标签和属性列表如下：

立即学习“PHP免费学习笔记（深入）”；

标签名	作用	包含属性
include	包含外部模板文件（闭合）	file
import	导入资源文件（闭合包括js css load别名）	file,href,type,value,basepath
volist	循环数组数据输出	name,id,offset,length,key,mod
foreach	数组或对象遍历输出	name,item,key
for	For循环数据输出	name,from,to,before,step
switch	分支判断输出	name
case	分支判断输出（必须和switch配套使用）	value,break
default	默认情况输出（闭合必须和switch配套使用）	无
compare	比较输出（包括eq neq lt gt egt elt heq nheq等别名）	name,value,type
range	范围判断输出（包括in notin between notbetween别名）	name,value,type
present	判断是否赋值	name
notpresent	判断是否尚未赋值	name
empty	判断数据是否为空	name
notempty	判断数据是否不为空	name
defined	判断常量是否定义	name
notdefined DBShop开源电子商务网店系统 DBShop电子商务系统具备统一的系统设置、简单的商品管理、灵活的商品标签、强大的商品属性、方便的配送费用管理、自由的客服设置、独立的广告管理、全面的邮件提醒、详细的管理权限设置、整合国内外知名支付网关、完善的系统更新（可在线自动更新或手动更新）功能、细致的帮助说明、无微不至的在线教程……，使用本系统绝对是一种享受！下载	判断常量是否未定义	name
define	常量定义（闭合）	name,value
assign	变量赋值（闭合）	name,value
if	条件判断输出	condition
elseif	条件判断输出（闭合必须和if标签配套使用）	condition
else	条件不成立输出（闭合可用于其他标签）	无
php	使用php代码	无

1.include

可以使用Include标签来包含外部的模板文件，使用方法如下：

include标签（包含外部模板文件）
闭合	闭合标签
属性	file（必须）：要包含的模板文件，支持变量

示例：

1、使用完整文件名包含

格式：

<include file="完整模板文件名" />

例如：

<include file="./Tpl/default/Public/header.html" />

这种情况下，模板文件名必须包含后缀。使用完整文件名包含的时候，特别要注意文件包含指的是服务器端包含，而不是包含一个URL地址，也就是说file参数的写法是服务器端的路径，如果使用相对路径的话，是基于项目的入口文件位置。

2、包含当前模块的其他操作模板文件

格式：

<include file="操作名" />

例如导入当前模块下面的read操作模版：

<include file="read" />

操作模板无需带后缀。

3、包含其他模块的操作模板

格式：

<include file="模块名:操作名" />

例如，包含Public模块的header操作模版：

<include file="Public:header" />

4、包含其他模板主题的模块操作模板

格式：

<include file="主题名:模块名:操作名" />

例如，包含blue主题的User模块的read操作模版：

<include file="blue:User:read" />

5、用变量控制要导入的模版

格式：

<include file="$变量名" />

例如

<include file="$tplName" />

给$tplName赋不同的值就可以包含不同的模板文件，变量的值的用法和上面的用法相同。

无论你使用什么方式包含外部模板，Include标签支持在包含文件的同时传入参数，例如，下面的例子我们在包含header模板的时候传入了title和keywords变量：

<include file="header" title="ThinkPHP框架"keywords="开源WEB开发框架"/>

就可以在包含的header.html文件里面使用var1和var2变量，方法

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>[title]</title>
<meta name="keywords" content="[keywords]" />
</head>

注意：由于模板解析的特点，从入口模板开始解析，如果外部模板有所更改，模板引擎并不会重新编译模板，除非在变量0下或者变量1已经过期。如果部署模式下修改了包含的外部模板文件后，需要把模块的缓存目录清空，否则无法生效。

以上就是thinkphp常用内置标签include的详解的内容，更多相关内容请关注PHP中文网（www.php.cn）！

PHP框架需要什么环境_ThinkPHP等框架环境要求【汇总】

php数据库怎么进用框架thinkphp进_phpThinkPHP连库法【步骤】

达内教ThinkPHP吗_框架学习内容与实战应用【教程】

Docker跑PHP框架要注意什么_跨平台容器化使用指南【指南】

PHP加密在ThinkPHP差别_不同版本助手函数用法【介绍】

PHP速学教程(入门到精通)

PHP怎么学习？PHP怎么入门？PHP在哪学？PHP怎么学才快？不用担心，这里为大家提供了PHP速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！

下载

相关专题

batoto漫画官网入口与网页版访问指南

本专题系统整理batoto漫画官方网站最新可用入口，涵盖最新官网地址、网页版登录页面及防走失访问方式说明，帮助用户快速找到batoto漫画官方平台，稳定在线阅读各类漫画内容。

127

2026.02.25

Steam官网正版入口与注册登录指南_新手快速进入游戏平台方法

本专题系统整理Steam官网最新可用入口，涵盖网页版登录地址、新用户注册流程、账号登录方法及官方游戏商店访问说明，帮助新手玩家快速进入Steam平台，完成注册登录并管理个人游戏库。

2026.02.25

TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者，系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例，帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

2026.02.25

Python数据处理流水线与ETL工程实战

本专题聚焦 Python 在数据工程场景下的实际应用，系统讲解 ETL 流程设计、数据抽取与清洗、批处理与增量处理方案，以及数据质量校验与异常处理机制。通过构建完整的数据处理流水线案例，帮助开发者掌握数据工程中的性能优化思路与工程化规范，为后续数据分析与机器学习提供稳定可靠的数据基础。

2026.02.25

Java领域驱动设计（DDD）与复杂业务建模实战

本专题围绕 Java 在复杂业务系统中的建模与架构设计展开，深入讲解领域驱动设计（DDD）的核心思想与落地实践。内容涵盖领域划分、聚合根设计、限界上下文、领域事件、贫血模型与充血模型对比，并结合实际业务案例，讲解如何在 Spring 体系中实现可演进的领域模型架构，帮助开发者应对复杂业务带来的系统演化挑战。

2026.02.25

Golang 生态工具与框架：扩展开发能力

《Golang 生态工具与框架》系统梳理 Go 语言在实际工程中的主流工具链与框架选型思路，涵盖 Web 框架、RPC 通信、依赖管理、测试工具、代码生成与项目结构设计等内容。通过真实项目场景解析不同工具的适用边界与组合方式，帮助开发者构建高效、可维护的 Go 工程体系，并提升团队协作与交付效率。

2026.02.24

Golang 性能优化专题：提升应用效率

《Golang 性能优化专题》聚焦 Go 应用在高并发与大规模服务中的性能问题，从 profiling、内存分配、Goroutine 调度、GC 机制到 I/O 与锁竞争逐层分析。结合真实案例讲解定位瓶颈的方法与优化策略，帮助开发者建立系统化性能调优思维，在保证代码可维护性的同时显著提升服务吞吐与稳定性。

2026.02.24