1.1 模版引擎,模版定义
User模块的add操作 对应的模板文件就应该是:
Tpl/User/add.html
例如 TMPL_FILE_DEPR如果配置成“_”的话,默认的模板文件就变成了:
Tpl/Home/User_add.html
1.2 模版引擎,模版赋值
要在模板中输出变量,必须在在Action类中把变量传递给模板,视图类提供了assign方法对模板变量赋值,无论何种变量类型都统一使用assign赋值。
$this->assign('name',$value);
//下面的写法是等效的
$this->name = $value;
如果要同时输出多个模板变量,可以使用下面的方式:
$array['name'] = 'thinkphp';
$array['email'] = 'liu21st@gmail.com';
$array['phone'] = '12335678';
$this->assign($array);
这样,就可以在模板文件中同时输出name、email和phone三个变量。
1.3 模版引擎,模版输出
模板变量赋值后就需要调用模板文件来输出相关的变量,模板调用通过display方法来实现。我们在操作方法的最后使用:
$this->display();
一、调用当前模块的其他操作模板
格式:display('操作名')
例如,假设当前操作是User模块下面的read操作,我们需要调用User模块的edit操作模版,使用:
$this->display('edit');
不需要写模板文件的路径和后缀。
二、调用其他模块的操作模板
格式:display('模块名:操作名')
例如,当前是User模块,我们需要调用Member模块的read操作模版,使用:
$this->display('Member:read');
$this->display('Public:menu');
输出这个模板文件。理解了这个,模板输出就清晰了。
三、调用其他主题的操作模板
格式:display('主题名:模块名:操作名')
例如我们需要调用Xp主题的User模块的edit操作模版,使用:
$this->display('Xp:User:edit');
这种方式需要指定模块和操作名
四、直接全路径输出模板
$this->display('./Public/menu.html');
$this->display('./Public/menu.tpl');
五、直接解析内容
Action类的display方法如果传入第四个参数,表示不读取模板文件而是直接解析内容。例如:
$this->assign('foo','ThinkPHP');
$this->show('Hello, {$foo}!');
会在页面输出: Hello,ThinkPHP!
直接输出的内容仍然支持模板布局功能。
show方法也可以支持指定编码和输出格式,例如:
$this->show($content, 'utf-8', 'text/xml');
事实上,display方法还有其他的参数和用法。
有时候某个模板页面我们需要输出指定的编码,而不是默认的编码,可以使用:
$this->display('Member:read', 'gbk');
或者输出的模板文件不是text/html格式的,而是XML格式的,可以用:
$this->display('Member:read', 'utf-8', 'text/xml');
如果你的网站输出编码不是默认的编码,可以使用:
'DEFAULT_CHARSET'=> 'gbk'
如果要输出XML格式的,可以用:
'TMPL_CONTENT_TYPE'=> 'text/xml'
1.4 模板替换
在进行模板输出之前,系统还会对渲染的模板结果进行一些模板的特殊字符串替换操作,也就是实现了模板输出的替换和过滤。模板替换适用于所有的模板引擎,包括原生的PHP模板。这个机制可以使得模板文件的定义更加方便,默认的替换规则有:
(注:为了部署安全考虑,!-Public-!和!-TMPL-!不再建议使用)
!-SELF-!: 会替换成当前的页面URL
注意这些特殊的字符串是严格区别大小写的,并且这些特殊字符串的替换规则是可以更改或者增加的,我们只需要在项目配置文件中配置TMPL_PARSE_STRING就可以完成。如果有相同的数组索引,就会更改系统的默认规则。例如:
'TMPL_PARSE_STRING' =>array(
'!-PUBLIC-!' => '/Common', // 更改默认的__PUBLIC__ 替换规则
'__JS__' => '/Public/JS/', // 增加新的JS类库路径替换规则
'__UPLOAD__' => '/Uploads', // 增加新的上传路径替换规则
)
有了模板替换规则后,页面上所有的!-PUBLIC-! 字符串都会被替换,那如果确实需要输出!-PUBLIC-! 字符串到模板呢,我们可以通过增加替换规则的方式,例如:
'TMPL_PARSE_STRING' =>array(
'--PUBLIC--' => '!-PUBLIC-!', // 采用新规则输出__PUBLIC__字符串
)
这样增加替换规则后,如果我们要输出!-PUBLIC-! 字符串,只需要在模板中添加--PUBLIC--,其他替换字符串的输出方式类似。
2 模版常用参数
模板引擎设置
配置名 说明 默认值
TMPL_CONTENT_TYPE 默认模板输出类型 text/html
TMPL_ACTION_SUCCESS 默认成功跳转对应的模板文件 同上
TMPL_DETECT_THEME 自动侦测模板主题 false
TMPL_TEMPLATE_SUFFIX 默认模板文件后缀 .html
TMPL_FILE_DEPR 模板文件模块与操作之间的分割符,只对项目分组部署有效 /
'TMPL_ENGINE_TYPE' 更改模版引擎
TMPL_PARSE_STRING' 修改定义模版替换规则
3 变量输出
我们已经知道了在Action中使用assign方法可以给模板变量赋值,赋值后怎么在模板文件中输出变量的值呢?
如果我们在Action中赋值了一个name模板变量:
$name = 'ThinkPHP';
$this->assign('name',$name);
使用内置的模板引擎输出变量,只需要在模版文件使用:
{$name}
模板编译后的结果就是
<?php echo($name);?>
最后运行的时候就可以在标签位置显示ThinkPHP的输出结果。
注意模板标签的{和$之间不能有任何的空格,否则标签无效。普通标签默认开始标记是 {,结束标记是 }。也可以通过设置TMPL_L_DELIM和TMPL_R_DELIM进行更改。例如,我们在项目配置文件中定义:
'TMPL_L_DELIM'=>'<{',
'TMPL_R_DELIM'=>'}>',
那么,上面的变量输出标签就应该改成:
<{$name}>
后面的内容我们都以默认的标签定义来说明。assign方法里面的第一个参数才是模板文件中使用的变量名称。如果改成下面的代码:
$name = 'ThinkPHP';
$this->assign('name2',$name);
再使用{$name} 输出就无效了,必须使用 {$name2}才能输出模板变量的值了。
如果我们需要把一个用户数据对象赋值给模板变量:
$User = M('name');
$user = $User->find(1);
$this->assign('user',$user);
也就是说$user其实是一个数组变量,我们可以使用下面的方式来输出相关的值:
{$user['name']}//输出用户的名称
{$user['email']} //输出用户的email地址
如果$user是一个对象而不是数组的话,
$User = M('name');
$User->find(1);
$this->assign('user',$User);
可以使用下面的方式输出相关的属性值:
{$user:name}// 输出用户的名称
{$user:email} // 输出用户的email地址
3.1版本以后,类的属性输出方式有所调整,支持原生的PHP对象写法,所以上面的标签需要改成:
{$user->name}// 输出用户的名称
{$user->email} // 输出用户的email地址
为了方便模板定义,还可以支持点语法,例如,上面的
{$user['name']}// 输出用户的名称
{$user['email']} // 输出用户的email地址
可以改成
{$user.name}
{$user.email}
因为点语法默认的输出是数组方式,所以上面两种方式是在没有配置的情况下是等效的。我们可以通过配置TMPL_VAR_IDENTIFY参数来决定点语法的输出效果,以下面的输出为例:
{$user.name}
如果TMPL_VAR_IDENTIFY设置为array,那么
{$user.name}和{$user['name']}等效,也就是输出数组变量。
如果TMPL_VAR_IDENTIFY设置为obj,那么
{$user.name}和{$user:name}等效,也就是输出对象的属性。
如果TMPL_VAR_IDENTIFY留空的话,系统会自动判断要输出的变量是数组还是对象,这种方式会一定程度上影响效率,而且只支持二维数组和两级对象属性。
如果是数组或者多层对象属性的输出,可以使用下面的定义方式:
{$user.sub.name}// 使用点语法输出
或者使用
{$user['sub']['name']}// 输出三维数组的值
{$user:sub:name}// 输出对象的多级属性