转载自:视频教程网
模板定义
为了对模板文件更加有效的管理,ThinkPHP对模板文件进行目录划分,默认的模板文件定义规则是:
模板目录/模板主题/[分组名/]模块名/操作名+模板后缀
模板目录默认是项目下面的Tpl, 模板主题默认是default,模板主题功能是为了多模板切换而设计的,如果有多个模板主题的话,可以用DEFAULT_THEME参数设置默认的模板主题名。
在每个模板主题下面,是以项目的模块名为目录,然后是每个模块的具体操作模板文件,例如:
User模块的add操作 对应的模板文件就应该是:Tpl/default/User/add.html
模板文件的默认后缀的情况是.html,也可以通过TMPL_TEMPLATE_SUFFIX来配置成其他的。
如果项目启用了模块分组功能(假设User模块属于Home分组),那么默认对应的模板文件可能变成 :Tpl/default/Home/User/add.html
当然,分组功能也提供了 TMPL_FILE_DEPR参数来配置简化模板的目录层次。
例如 TMPL_FILE_DEPR如果配置成“_”的话,默认的模板文件就变成了:
Tpl/default/Home/User_add.html
正是因为系统有这样一种模板文件自动识别的规则,所以通常的display方法无需带任何参数即可输出对应的模板。
模板输出
模板变量赋值后就需要调用模板文件来输出相关的变量,模板调用通过display方法来实现。我们在操作方法的最后使用:
$this->display();
根据前面的模板定义规则,因为系统会按照默认规则自动定位模板文件,所以通常display方法无需带任何参数即可输出对应的模板。这是模板输出的最简单的用法。
事情总有特例,或者根本不需要按模块进行分目录存放,不过display方法总是能够帮你解决问题。
Display方法提供了几种规则让你可以随心所欲的输出需要的模板,无论你的模板文件在什么位置。
下面来看具体的用法:
一、调用当前模块的其他操作模板
格式:display('操作名')
例如,假设当前操作是User模块下面的read操作,我们需要调用User模块的edit操作模版,使用:
$this->display('edit');
不需要写模板文件的路径和后缀。
二、调用其他模块的操作模板
格式:display('分组名:模块名:操作名') 其中分组名是可选的
例如,当前是User模块,我们需要调用Member模块的read操作模版 ,使用:
$this->display('Member:read');
如果要调用分组Admin的Member模块的read操作模板,可以使用:
$this->display('Admin:Member:read');
这种方式也不需要写模板文件的路径和后缀,严格来说,这里面的模块名和操作名并不一定需要有对应的模块或者操作,只是一个目录名称和文件名称而已,例如,你的项目里面可能根本没有Public模块,更没有Public模块的menu操作,但是一样可以使用
$this->display('Public:menu');
输出这个模板文件。理解了这个,模板输出就清晰了。
三、调用其他主题的操作模板
格式:display('主题名@模块名:操作名')
例如我们需要 调用Xp主题的User模块的edit操作模版,使用:
$this->display('Xp@User:edit');
这种方式需要指定模块和操作名
四、直接全路径输出模板
格式:display('模板文件名')
例如,我们直接输出当前的Public目录下面的menu.html模板文件,使用:
$this->display('./Public/menu.html');
这种方式需要指定模板路径和后缀,这里的Public目录是位于当前项目入口文件位置下面。如果是其他的后缀文件,也支持直接输出,例如:
$this->display('./Public/menu.tpl');
只要./Public/menu.tpl是一个实际存在的模板文件。如果使用的是相对路径的话,要注意当前位置是相对于项目的入口文件,而不是模板目录。
事实上,display方法还有其他的参数和用法。
有时候某个模板页面我们需要输出指定的编码,而不是默认的编码,可以使用:
$this->display('Member:read', 'gbk');
或者输出的模板文件不是text/html格式的,而是XML格式的,可以用:
$this->display('Member:read', 'utf-8', 'text/xml');