ThinkPHP3.2.3变量输出


在上一章我们了解了如何通过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_DELIMTMPL_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}

总结

通过本篇的学习,我们掌握了如何在模板文件中输出变量和使用函数、默认值和运算符,下一篇我们将会了解如何进行模板变量的循环、判断等控制输出,以及导入其他公共模板。