ThinkPHP 学习笔记二模版

最新推荐文章于 2021-03-10 12:59:26 发布

原创最新推荐文章于 2021-03-10 12:59:26 发布 · 6.2k 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#模板引擎 #action #user #php #url #exception

ThinkPHP 专栏收录该内容

4 篇文章

订阅专栏

1.模版定义

默认的模板文件定义规则是：
模板目录/模板主题/[分组名/]模块名/操作名+模板后缀
模板目录默认是项目下面的Tpl，模板主题默认是default，模板主题功能是为了多模板切换而设计的，如果有多个模板主题的话，可以用TMPL_DEFAULT_THEME 参数设置默认的模板主题名。
在每个模板主题下面，是以项目的模块名为目录，然后是每个模块的具体操作模板文件，例如：
User模块的add操作对应的模板文件就应该是：Tpl/default/User/add.html
模板文件的默认后缀的情况是.html，也可以通过TMPL_TEMPLATE_SUFFIX来配置成其他的。
如果项目启用了模块分组功能（假设User模块属于Home分组），那么默认对应的模板文件可能变成：Tpl/default/Home/User/add.html

2. 模版赋值

要在模板中输出变量，必须在在Action类中把变量传递给模板，视图类提供了 assign方法对模板变量赋值，无论何种变量类型都统一使用assign赋值。

$this->assign('name',$value);

3.模版调用

模板变量赋值后就需要调用模板文件来输出相关的变量，模板调用通过display方法来实现。我们在操作方法的最后使用：

$this->display();

根据前面的模板定义规则，因为系统会按照默认规则自动定位模板文件，所以通常display方法无需带任何参数即可输出对应的模板。这是模板输出的最简单的用法。
一、调用当前模块的其他操作模板
格式：display('操作名')
例如，假设当前操作是User模块下面的read操作，我们需要调用User模块的edit操作模版，使用：

$this->display('edit');

不需要写模板文件的路径和后缀。

二、调用其他模块的操作模板
格式：display('分组名:模块名:操作名') 其中分组名是可选的
例如，当前是User模块，我们需要调用Member模块的read操作模版，使用：

$this->display('Member:read');

三、调用其他主题的操作模板
格式：display('主题名@模块名:操作名')

例如我们需要调用Xp主题的User模块的edit操作模版，使用：

$this->display('Xp@User:edit');

四、直接全路径输出模板
格式：display('模板文件名')
例如，我们直接输出当前的Public目录下面的menu.html模板文件，使用：
$this->display('./Public/menu.html');

这种方式需要指定模板路径和后缀，这里的Public目录是位于当前项目入口文件位置下面。如果是其他的后缀文件，也支持直接输出

4.模板替换

在进行模板输出之前，系统还会对渲染的模板结果进行一些模板的特殊字符串替换操作，也就是实现了模板输出的替换和过滤。这个机制可以使得模板文件的定义更加方便，默认的替换规则有：

./ Public：会被替换成当前项目的公共模板目录通常是 /项目目录/Tpl/default/Public/
__ PUBLIC __：会被替换成当前网站的公共目录通常是 /Public/
__ TMPL __：会替换成项目的模板目录通常是 /项目目录/Tpl/dfault/
__ ROOT __：会替换成当前网站的地址（不含域名）
__ APP __：会替换成当前项目的URL地址（不含域名）
__ URL __：会替换成当前模块的URL地址（不含域名）
__ ACTION __：会替换成当前操作的URL地址（不含域名）
__ SELF __：会替换成当前的页面URL

注意这些特殊的字符串是严格区别大小写的，并且这些特殊字符串的替换规则是可以更改或者增加的，我们只需要在项目配置文件中配置TMPL_PARSE_STRING就可以完成。如果有相同的数组索引，就会更改系统的默认规则

TMPL_PARSE_STRING => array(

'__ PUBLIC __' => '/Common', // 更改默认的__ PUBLIC __ 替换规则

'__UPLOAD__' => '/Public/Uploads/', // 增加新的上传路径替换规则

)

5. 获取内容

有些时候我们不想直接输出模板内容，而是希望对内容再进行一些处理后输出，就可以使用fetch方法来获取解析后的模板内容，在Action类里面使用：

$content = $this->fetch();

fetch的参数用法和Display方法基本一致，
8. 静态生成

ThinkPHP提供了灵活的静态文件生成功能，可以在输出模板的同时生成需要的静态文件，以供调用。
在Action中使用buildHtml方法即可创建静态文件，buildHtml方法的第一个参数就要生成的静态文件名，后面的参数和display方法一致，内部其实是调用了前面提到的fetch方法获取模板输出然后创建静态文件。用法如下：

$this->buildHtml('静态文件', '静态路径','模板文件');

静态路径如果留空的话默认保存在HTML_PATH（默认的HTML_PATH路径位于项目目录下面的Html目录，如果没有的话手动创建）定义的路径下面，静态文件可以随意设置，也可以包括路径，如果不存在的路径系统会自动创建

9. 模板引擎

系统支持原生的PHP模板，而且本身内置了一个基于XML的高效的编译型模板引擎，无论在功能还是性能方面都优秀过Smarty。系统默认使用的模板引擎是内置模板引擎，关于这个模板引擎的标签详细使用可以参考模板指南部分。
内置的模板引擎也可以直接支持在模板文件中采用PHP原生代码和模板标签的混合使用，如果需要完全使用PHP本身作为模板引擎，可以配置：

'TMPL_ENGINE_TYPE' => 'PHP'

可以达到最佳的效率

10. 使用第三方模板引擎

系统支持模板引擎的扩展机制，并且官方提供了包括Smarty、EaseTemplate、TemplateLite和Smart在内的第三方模板引擎扩展。我们以Smarty模板引擎为例，来说明下如何使用第三方模板引擎。
首先，需要下载官方的模板引擎扩展，并放到系统目录的LibThinkUtilTemplate目录下面，然后，下载最新的Smarty模板引擎文件放到系统目录的Vendor第三方类库目录。
剩下的，我们要做的只是简单的配置下模板引擎名称即可，例如在项目配置文件里面设置：

'TMPL_ENGINE_TYPE' => 'Smarty'

区别就在于display方法直接输出模板文件渲染后的内容，而fetch方法是返回模板文件渲染后的内容。如何对返回的结果content进行处理，完全由开发人员自行决定了。这是模板替换的另外一种高级方式，比较灵活，而且不需要通过配置的方式。
注意，fetch方法仍然会执行上面的模板替换操作。

6. 布局模版

7. 系统模板

系统有一些内置的模板文件用于异常页面和页面Trace功能的输出，你可以定制这些模板页面，满足自己的需要。默认的系统模板主要有：

页面Trace模板：默认位于系统目录的Tpl/PageTrace.tpl.php 是一个php文件，可更改TMPL_TRACE_FILE进行配置。

异常模板：默认位于系统目录的Tpl/ThinkException.tpl.php，可以更改TMPL_EXCEPTION_FILE进行配置。