ThinkPHP3.1模板变量输出详解教程

摘要： 在上一章我们了解了如何通过assign方法把变量赋值到模板变量，这一篇我们来详细了解下如何在模板中使用标签输出模板变量。注意，本篇的描述仅针对使用内部模板引擎的情况，如果你使用了S...

在上一章我们了解了如何通过assign方法把变量赋值到模板变量，这一篇我们来详细了解下如何在模板中使用标签输出模板变量。
注意，本篇的描述仅针对使用内部模板引擎的情况，如果你使用了Smarty或者其他模板引擎，请参考其相关的变量输出语法。

变量输出

变量输出的方法很简单，例如，在控制器中我们给模板变量赋值：

$name = 'ThinkPHP';
$this->assign('name',$name);
$this->display();

然后就可以在模板中使用：

Hello,{$name}！

模板编译后的结果就是：

Hello,<?php echo($name);?>！

这样，运行的时候就会在模板中显示：

Hello,ThinkPHP！

[-more-]
注意模板标签的{和$之间不能有任何的空格，否则标签无效。所以，下面的标签

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="名称为空"}

使用运算符

我们可以对模板输出使用运算符，包括对“+”“ –” “*” “/”和“%”的支持。
例如：

在使用运算符的时候，不再支持点语法和常规的函数用法，例如：

{$user.score+10} //错误的
{$user['score']+10} //正确的
{$user['score']*$user['level']} //正确的
{$user['score']|myFun*10} //错误的
{$user['score']+myFun($user['level'])} //正确的

总结

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