快速入门 8:变量输出
最后更新于:2022-04-01 00:18:31
# 快速入门(八):变量输出
在上一章我们了解了如何通过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}
~~~
## 总结
通过本篇的学习,我们掌握了如何在模板文件中输出变量和使用函数、默认值和运算符,下一篇我们将会了解如何进行模板变量的循环、判断等控制输出,以及导入其他公共模板。