在上一章我们了解了如何通过assign方法把变量赋值到模板变量,这一篇我们来详细了解下如何在模板中使用标签输出模板变量。
注意,本篇的描述仅针对使用内部模板引擎的情况,如果你使用了Smarty或者其他模板引擎,请参考其相关的变量输出语法。
变量输出(这里主要是指标量类型的输出)的方法很简单,例如,在控制器中我们给模板变量赋值:
$name = 'ThinkPHP'; $this->assign('name',$name); $this->display();
然后就可以在模板中使用:
Hello,{$name}!
模板编译后的结果就是:
Hello,<?php echo($name);?>!
这样,运行的时候就会在模板中显示:
Hello,ThinkPHP!
注意模板标签的{
和$
之间不能有任何的空格,否则标签无效。所以,下面的标签
Hello,{ $name}!
将不会正常输出name变量,而是直接保持不变输出:
Hello,{ $name}!
普通标签默认开始标记是 {
,结束标记是}
。也可以通过设置TMPL_L_DELIM
和TMPL_R_DELIM
进行更改。例如,我们在项目配置文件中定义:
'TMPL_L_DELIM'=>'<{','TMPL_R_DELIM'=>'}>',
那么,上面的变量输出标签就应该改成:
Hello,<{$name}>!
后面的内容我们都以默认的标签定义来说明。
模板标签的变量输出根据变量类型有所区别,刚才我们输出的是字符串变量,如果是数组变量,
$data['name'] = 'ThinkPHP'; $data['email'] = 'thinkphp@qq.com'; $this->assign('data',$data);
那么,在模板中我们可以用下面的方式输出:
Name:{$data.name} Email:{$data.email}
或者用下面的方式也是有效:
Name:{$data['name']} Email:{$data['email']}
当我们要输出多维数组的时候,往往要采用后面一种方式。
如果data变量是一个对象(并且包含有name和email两个属性),那么可以用下面的方式输出:
Name:{$data:name}Email:{$data:email}
或者
Name:{$data->name}Email:{$data->email}
普通的模板变量需要首先赋值后才能在模板中输出,但是系统变量则不需要,可以直接在模板中输出,系统变量的输出通常以{$Think
打头,例如:
{$Think.server.script_name} // 输出$_SERVER['SCRIPT_NAME']变量 {$Think.session.user_id} // 输出$_SESSION['user_id']变量 {$Think.get.pageNumber} // 输出$_GET['pageNumber']变量 {$Think.cookie.name} // 输出$_COOKIE['name']变量
支持输出$_SERVER、$_ENV、 $_POST、 $_GET、 $_REQUEST、$_SESSION和 $_COOKIE
变量。
还可以输出常量
{$Think.const.MODULE_NAME}
或者直接使用
{$Think.MODULE_NAME}
输出配置参数使用:
{$Think.config.db_charset} {$Think.config.url_model}
输出语言变量可以使用:
{$Think.lang.page_error} {$Think.lang.var_error}
我们往往需要对模板输出变量使用函数,可以使用:
{$data.name|md5}
编译后的结果是:
<?php echo (md5($data['name'])); ?>
如果函数有多个参数需要调用,则使用:
{$create_time|date="y-m-d",###}
表示date函数传入两个参数,每个参数用逗号分割,这里第一个参数是y-m-d,第二个参数是前面要输出的create_time变量,因为该变量是第二个参数,因此需要用###
标识变量位置,编译后的结果是:
<?php echo (date("y-m-d",$create_time)); ?>
如果前面输出的变量在后面定义的函数的第一个参数,则可以直接使用:
{$data.name|substr=0,3}
表示输出
<?php echo (substr($data['name'],0,3)); ?>
虽然也可以使用:
{$data.name|substr=###,0,3}
但完全没用这个必要。
还可以支持多个函数过滤,多个函数之间用“|”分割即可,例如:
{$name|md5|strtoupper|substr=0,3}
编译后的结果是:
<?php echo (substr(strtoupper(md5($name)),0,3)); ?>
函数会按照从左到右的顺序依次调用。
如果你觉得这样写起来比较麻烦,也可以直接这样写:
{:substr(strtoupper(md5($name)),0,3)}
我们可以给变量输出提供默认值,例如:
{$user.nickname|default="这家伙很懒,什么也没留下"}
对系统变量依然可以支持默认值输出,例如:
{$Think.get.name|default="名称为空"}
默认值和函数可以同时使用,例如:
{$Think.get.name|getName|default="名称为空"}
我们可以对模板输出使用运算符,包括对“+”“ –” “*” “/”和“%”的支持。
例如:
运算符 | 使用示例 |
---|---|
+ | {$a+$b} |
- | {$a-$b} |
* | {$a*$b} |
/ | {$a/$b} |
% | {$a%$b} |
++ | {$a++} 或 {++$a} |
-- | {$a--} 或 {--$a} |
综合运算 | {$a+$b*10+$c} |
在使用运算符的时候,不再支持点语法和常规的函数用法,例如:
{$user.score+10} //错误的 {$user['score']+10} //正确的 {$user['score']*$user['level']} //正确的 {$user['score']|myFun*10} //错误的 {$user['score']+myFun($user['level'])} //正确的
模板可以支持三元运算符,例如:
{$status?'正常':'错误'} {$info['status']?$info['msg']:$info['error']}
三元运算符中暂时不支持点语法,因此下面的写法是错误的:
{$info.status?$info.msg:$info.error}
通过本篇的学习,我们掌握了如何在模板文件中输出变量和使用函数、默认值和运算符,下一篇我们将会了解如何进行模板变量的循环、判断等控制输出,以及导入其他公共模板。