在模板中输出变量的方法很简单，例如
~~~
{$name}
~~~
模板编译后的结果就是：
~~~
<?php echo htmlentities($name);?>
~~~
注意模板标签的`{`和`$`之间不能有任何的空格，否则标签无效。所以，下面的标签
~~~
{ $name}
~~~
将不会正常输出name变量，而是直接保持不变输出：
模板标签的变量输出根据变量类型有所区别，刚才我们输出的是字符串变量，如果是数组变量
~~~
$data['name'] = 'ThinkPHP';
$data['email'] = 'thinkphp@qq.com';
~~~
那么，在模板中我们可以用下面的方式输出：
~~~
Name：{$data.name}
Email：{$data.email}
~~~
或者用下面的方式也是有效：
~~~
Name：{$data['name']}
Email：{$data['email']}
~~~
>[info] 当我们要输出多维数组的时候，往往要采用后面一种方式。
如果`data`变量是一个对象（并且包含有`name`和`email`两个属性），那么可以用下面的方式输出：
~~~
Name：{$data->name}
Email：{$data->email}
~~~
也可以直接调用对象的常量或者方法
~~~
常量：{$data::CONST_NAME}
方法：{$data->fun()}
~~~
## 使用默认值
我们可以给变量输出提供默认值，例如：
~~~
{$user.nickname|default="这家伙很懒，什么也没留下"}
~~~
对系统变量依然可以支持默认值输出，例如：
~~~
{$Think.get.name|default="名称为空"}
~~~
默认值和函数可以同时使用，例如：
~~~
{$Think.get.name|getName|default="名称为空"}
~~~
## 系统变量输出
普通的模板变量需要首先赋值后才能在模板中输出，但是系统变量则不需要，可以直接在模板中输出，系统变量的输出通常以`{$Think.`（大小写一致） 打头，例如：
~~~
{$Think.server.script_name} // 输出$_SERVER['SCRIPT_NAME']变量
{$Think.session.user_id} // 输出$_SESSION['user_id']变量
{$Think.get.page} // 输出$_GET['page']变量
{$Think.cookie.name} // 输出$_COOKIE['name']变量
~~~
支持输出`$_SERVER`、`$_ENV`、`$_POST`、`$_GET`、`$_REQUEST`、`$_SESSION`和`$_COOKIE`变量。
## 常量输出
还可以输出常量
~~~
{$Think.const.PHP_VERSION}
~~~
或者直接使用
~~~
{$Think.PHP_VERSION}
~~~
## 配置输出
输出配置参数使用：
~~~
{$Think.config.default_module}
{$Think.config.default_controller}
~~~
## 使用函数
需要对模板输出使用函数进行过滤或其它处理的时候，可以使用：
~~~
{$data.name|md5}
~~~
可以使用空格，例如下面的写法是一样的：
~~~
{$data.name | md5}
~~~
编译后的结果是：
~~~
<?php echo htmlentities(md5($data['name'])); ?>
~~~
其中`htmlentities`方法是系统默认添加的（无需手动指定。
> 为了避免出现XSS安全问题，默认的变量输出都会使用`htmlentities`方法进行转义输出。
你还可以设置默认的过滤方法，在配置文件`template.php`中设置
~~~
'default_filter' => 'htmlspecialchars'
~~~
就会默认使用`htmlspecialchars`方法过滤输出。
如果你不需要转义（例如你需要输出html表格等内容），可以使用：
~~~
{$data.name|raw}
~~~
编译后的结果是：
~~~
<?php echo $data['name']; ?>
~~~
系统内置了下面几个固定的过滤规则（不区分大小写）
| 过滤方法 | 描述 |
| --- | --- |
| date | 日期格式化（支持各种时间类型） |
| format | 字符串格式化 |
| upper | 转换为大写 |
| lower | 转换为小写 |
| first | 输出数组的第一个元素 |
| last | 输出数组的最后一个元素 |
| default | 默认值 |
| raw | 不使用（默认）转义 |
例如
~~~
{$data.create_time|date='Y-m-d H:i'}
{$data.number|format='%02d'}
~~~
如果函数有多个参数需要调用，可以使用
~~~
{$data.name|substr=0,3}
~~~
表示输出
~~~
<?php echo htmlentities(substr($data['name'],0,3)); ?>
~~~
还可以支持多个函数过滤，多个函数之间用“|”分割即可，例如：
~~~
{$name|md5|upper|substr=0,3}
~~~
编译后的结果是：
~~~
<?php echo htmlentities(substr(strtoupper(md5($name)),0,3)); ?>
~~~
函数会按照从左到右的顺序依次调用（系统默认的过滤规则会在最后调用）。
> 变量输出使用的函数可以支持内置的PHP函数或者用户自定义函数，甚至是静态方法。
如果你觉得这样写起来比较麻烦，也可以直接这样写：
~~~
{:substr(strtoupper(md5($name)),0,3)}
~~~
> 使用该方法输出的值不会使用默认的过滤方法进行转义。
## 运算符
我们可以对模板输出使用运算符，包括如下支持。
| 运算符 | 使用示例 |
| --- | --- |
| `+` | `{$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 }
~~~
还支持如下的写法：
~~~
{$name ?? '默认值'}
~~~
表示如果有设置`$name`则输出`$name`,否则输出`默认值`。
~~~
{$name?='默认值'}
~~~
表示$name为真时才输出默认值。
~~~
{$name ?: 'NO'}
~~~
表示如果$name为真则输出$name，否则输出NO。
~~~
{$a==$b ? 'yes' : 'no'}
~~~
前面的表达式为真输出yes,否则输出no， 条件可以是==、===、!=、!==、>=、<=
## 包含文件
在当前模版文件中包含其他的模版文件使用include标签，标签用法：
~~~
{include file='模版文件1,模版文件2,...' /}
~~~
### 使用模版文件
可以直接包含一个模版文件名（包含完整路径），例如：
~~~
{include file="../application/view/default/public/header.html" /}
~~~
### 传入参数
无论你使用什么方式包含外部模板，Include标签支持在包含文件的同时传入参数，例如，下面的例子我们在包含header模板的时候传入了`title`和`keywords`参数：
~~~
{include file="Public/header" title="$title" keywords="开源WEB开发框架" /}
~~~
就可以在包含的header.html文件里面使用title和keywords变量，如下：
~~~
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>[title]</title>
<meta name="keywords" content="[keywords]" />
</head>
~~~
上面title参数传入的是个变量`$title`，模板内的`[title]`最终会替换成`$title`的值，当然`$title`这个变量必须要存在。
# 循环标签
*****
## `FOREACH`标签
`foreach`标签的用法和PHP语法非常接近，用于循环输出数组或者对象的属性，用法如下：
~~~
$list = User::all();
$this->assign('list',$list);
~~~
模板文件中可以这样输出
~~~
{foreach $list as $key=>$vo }
{$vo.id}:{$vo.name}
{/foreach}
~~~
可以不通过模板变量赋值，支持使用函数或者方法获取数据循环输出：
~~~
{foreach :model('user')->all() as $key=>$vo }
{$vo.id}:{$vo.name}
{/foreach}
~~~
## `VOLIST`标签
`volist`标签通常用于查询数据集或者二维数组的结果输出。 在控制器中首先对模版赋值：
~~~
$list = User::all();
$this->assign('list',$list);
~~~
在模版定义如下，循环输出用户的编号和姓名：
~~~
{volist name="list" id="vo"}
{$vo.id}:{$vo.name}<br/>
{/volist}
~~~
`Volist`标签的`name`属性表示模板赋值的变量名称，因此不可随意在模板文件中改变。`id`表示当前的循环变量，可以随意指定，但确保不要和`name`属性冲突，例如：
~~~
{volist name="list" id="data"}
{$data.id}:{$data.name}<br/>
{/volist}
~~~
可以直接使用函数设定数据集，而不需要在控制器中给模板变量赋值传入数据集变量，如：
~~~
{volist name=":model('user')->all()" id="vo"}
{$vo.name}
{/volist}
~~~
支持输出查询结果中的部分数据，例如输出其中的第5～15条记录
~~~
{volist name="list" id="vo" offset="5" length='10'}
{$vo.name}
{/volist}
~~~
输出偶数记录
~~~
{volist name="list" id="vo" mod="2" }
{eq name="mod" value="1"}{$vo.name}{/eq}
{/volist}
~~~
`mod`属性还用于控制一定记录的换行，例如：
~~~
{volist name="list" id="vo" mod="5" }
{$vo.name}
{eq name="mod" value="4"}<br/>{/eq}
{/volist}
~~~
为空的时候输出提示：
~~~
{volist name="list" id="vo" empty="暂时没有数据" }
{$vo.id}|{$vo.name}
{/volist}
~~~
`empty`属性不支持直接传入html语法，但可以支持变量输出，例如：
~~~
$this->assign('empty','<span class="empty">没有数据</span>');
$this->assign('list',$list);
~~~
然后在模板中使用：
~~~
{volist name="list" id="vo" empty="$empty" }
{$vo.id}|{$vo.name}
{/volist}
~~~
输出循环变量：
~~~
{volist name="list" id="vo" key="k" }
{$k}.{$vo.name}
{/volist}
~~~
如果没有指定`key`属性的话，默认使用循环变量i，例如：
~~~
{volist name="list" id="vo" }
{$i}.{$vo.name}
{/volist}
~~~
如果要输出数组的索引，可以直接使用`key`变量，和循环变量不同的是，这个`key`是由数据本身决定，而不是循环控制的，例如：
~~~
{volist name="list" id="vo" }
{$key}.{$vo.name}
{/volist}
~~~
## `FOR`标签
用法：
~~~
{for start="开始值" end="结束值" comparison="" step="步进值" name="循环变量名" }
{/for}
~~~
开始值、结束值、步进值和循环变量都可以支持变量，开始值和结束值是必须，其他是可选。comparison 的默认值是lt，name的默认值是i，步进值的默认值是1，举例如下：
~~~
{for start="1" end="100"}
{$i}
{/for}
~~~
解析后的代码是
~~~
for ($i=1;$i<100;$i+=1){
echo $i;
}
~~~
# 比较标签
*****
比较标签用于简单的变量比较，复杂的判断条件可以用if标签替换，比较标签是一组标签的集合，基本上用法都一致，如下：
~~~
{比较标签 name="变量" value="值"}
内容
{/比较标签}
~~~
系统支持的比较标签以及所表示的含义分别是：
| 标签 | 含义 |
| --- | --- |
| eq或者 equal | 等于 |
| neq 或者notequal | 不等于 |
| gt | 大于 |
| egt | 大于等于 |
| lt | 小于 |
| elt | 小于等于 |
| heq | 恒等于 |
| nheq | 不恒等于 |
他们的用法基本是一致的，区别在于判断的条件不同，并且所有的比较标签都可以和else标签一起使用。
例如，要求name变量的值等于value就输出，可以使用：
~~~
{eq name="name" value="value"}value{/eq}
~~~
或者
~~~
{equal name="name" value="value"}value{/equal}
~~~
也可以支持和else标签混合使用：
~~~
{eq name="name" value="value"}
相等
{else/}
不相等
{/eq}
~~~
当 name变量的值大于5就输出
~~~
{gt name="name" value="5"}value{/gt}
~~~
当name变量的值不小于5就输出
~~~
{egt name="name" value="5"}value{/egt}
~~~
比较标签中的变量可以支持对象的属性或者数组，甚至可以是系统变量，例如： 当vo对象的属性（或者数组，或者自动判断）等于5就输出
~~~
{eq name="vo.name" value="5"}
{$vo.name}
{/eq}
~~~
当vo对象的属性等于5就输出
~~~
{eq name="vo:name" value="5"}
{$vo.name}
{/eq}
~~~
当$vo\['name'\]等于5就输出
~~~
{eq name="vo['name']" value="5"}
{$vo.name}
{/eq}
~~~
而且还可以支持对变量使用函数 当vo对象的属性值的字符串长度等于5就输出
~~~
{eq name="vo:name|strlen" value="5"}{$vo.name}{/eq}
~~~
变量名可以支持系统变量的方式，例如：
~~~
{eq name="Think.get.name" value="value"}相等{else/}不相等{/eq}
~~~
通常比较标签的值是一个字符串或者数字，如果需要使用变量，只需要在前面添加“$”标志： 当vo对象的属性等于$a就输出
~~~
{eq name="vo:name" value="$a"}{$vo.name}{/eq}
~~~
所有的比较标签可以统一使用compare标签（其实所有的比较标签都是compare标签的别名），例如： 当name变量的值等于5就输出
~~~
{compare name="name" value="5" type="eq"}value{/compare}
~~~
等效于
~~~
{eq name="name" value="5" }value{/eq}
~~~
其中type属性的值就是上面列出的比较标签名称
# 条件判断
*****
## SWITCH标签
**用法：**
~~~
{switch 变量 }
{case value1 }输出内容1{/case}
{case value2}输出内容2{/case}
{default /}默认情况
{/switch}
~~~
使用示例：
~~~
{switch User.level}
{case 1}value1{/case}
{case 2}value2{/case}
{default /}default
{/switch}
~~~
可以使用函数以及系统变量，例如：
~~~
{switch User.level|intval }
{case 1}admin{/case}
{default /}default
{/switch}
~~~
对于case属性可以支持多个条件的判断，使用”|”进行分割，例如：
~~~
{switch Think.get.type}
{case gif|png|jpg}图像格式{/case}
{default /}其他格式
{/switch}
~~~
表示如果`$_GET["type"]`是gif、png或者jpg的话，就判断为图像格式。
也可以对case的value属性使用变量，例如：
~~~
{switch $User.userId}
{case $adminId}admin{/case}
{case $memberId}member{/case}
{/switch}
~~~
> 使用变量方式的情况下，不再支持`|`分割的多个条件判断用法。
## IF标签
**用法：**
~~~
{if 表达式}value1
{elseif 表达式 /}value2
{else /}value3
{/if}
~~~
用法示例：
~~~
{if ( $name == 1) OR ( $name > 100) } value1
{elseif $name == 2 /}value2
{else /} value3
{/if}
~~~
可以使用php代码，例如：
~~~
{if strtoupper($user['name']) == 'THINKPHP' }ThinkPHP
{else /} other Framework
{/if}
~~~
判断条件可以支持点语法和对象语法，例如：
~~~
{if $user.name == 'ThinkPHP'}ThinkPHP
{else /} other Framework
{/if}
{if $user->name == 'ThinkPHP'}ThinkPHP
{else /} other Framework
{/if}
~~~
> 如果某些特殊的要求下面，IF标签仍然无法满足要求的话，可以使用原生php代码或者PHP标签来直接书写代码。
## 范围判断
范围判断标签包括`in`/`notin`/`between`/`notbetween`四个标签，都用于判断变量是否中某个范围。
### IN和NOTIN
用法： 假设我们中控制器中给id赋值为1：
~~~
$id = 1;
$this->assign('id',$id);
~~~
我们可以使用in标签来判断模板变量是否在某个范围内，例如：
~~~
{in name="id" value="1,2,3"}
id在范围内
{/in}
~~~
最后会输出：`id在范围内`。
如果判断不在某个范围内，可以使用notin标签：
~~~
{notin name="id" value="1,2,3"}
id不在范围内
{/notin}
~~~
最后会输出：`id不在范围内`。
可以把上面两个标签合并成为：
~~~
{in name="id" value="1,2,3"}
id在范围内
{else/}
id不在范围内
{/in}
~~~
name属性还可以支持直接判断系统变量，例如：
~~~
{in name="Think.get.id" value="1,2,3"}
$_GET['id'] 在范围内
{/in}
~~~
> 更多的系统变量用法可以参考[系统变量](https://www.kancloud.cn/manual/thinkphp5_1/125004)部分。
value属性也可以使用变量，例如：
~~~
{in name="id" value="$range"}
id在范围内
{/in}
~~~
$range变量可以是数组，也可以是以逗号分隔的字符串。
value属性还可以使用系统变量，例如：
~~~
{in name="id" value="$Think.post.ids"}
id在范围内
{/in}
~~~
### BETWEEN 和 NOTBETWEEN
可以使用`between`标签来判断变量是否在某个区间范围内，可以使用：
~~~
{between name="id" value="1,10"}
输出内容1
{/between}
~~~
同样，也可以使用`notbetween`标签来判断变量不在某个范围内：
~~~
{notbetween name="id" value="1,10"}
输出内容2
{/notbetween}
~~~
也可以使用`else`标签把两个用法合并，例如：
~~~
{between name="id" value="1,10"}
输出内容1
{else/}
输出内容2
{/between}
~~~
当使用`between`标签的时候，`value`只需要一个区间范围，也就是只支持两个值，后面的值无效，例如
~~~
{between name="id" value="1,3,10"}
输出内容1
{/between}
~~~
实际判断的范围区间是`1~3`，而不是`1~10`，也可以支持字符串判断，例如：
~~~
{between name="id" value="A,Z"}
输出内容1
{/between}
~~~
name属性可以直接使用系统变量，例如：
~~~
{between name="Think.post.id" value="1,5"}
输出内容1
{/between}
~~~
value属性也可以使用变量，例如：
~~~
{between name="id" value="$range"}
输出内容1
{/between}
~~~
变量的值可以是字符串或者数组，还可以支持系统变量。
~~~
{between name="id" value="$Think.get.range"}
输出内容1
{/between}
~~~
## PRESENT/NOTPRESENT标签
present标签用于判断某个变量是否已经定义，用法：
~~~
{present name="name"}
name已经赋值
{/present}
~~~
如果判断没有赋值，可以使用：
~~~
{notpresent name="name"}
name还没有赋值
{/notpresent}
~~~
可以把上面两个标签合并成为：
~~~
{present name="name"}
name已经赋值
{else /}
name还没有赋值
{/present}
~~~
present标签的name属性可以直接使用系统变量，例如：
~~~
{present name="Think.get.name"}
$_GET['name']已经赋值
{/present}
~~~
## EMPTY/NOTEMPTY 标签
empty标签用于判断某个变量是否为空，用法：
~~~
{empty name="name"}
name为空值
{/empty}
~~~
如果判断没有赋值，可以使用：
~~~
{notempty name="name"}
name不为空
{/notempty}
~~~
可以把上面两个标签合并成为：
~~~
{empty name="name"}
name为空
{else /}
name不为空
{/empty}
~~~
name属性可以直接使用系统变量，例如：
~~~
{empty name="Think.get.name"}
$_GET['name']为空值
{/empty}
~~~
## DEFINED 标签
DEFINED标签用于判断某个常量是否有定义，用法如下：
~~~
{defined name="NAME"}
NAME常量已经定义
{/defined}
~~~
> name属性的值要注意严格大小写
如果判断没有被定义，可以使用：
~~~
{notdefined name="NAME"}
NAME常量未定义
{/notdefined}
~~~
可以把上面两个标签合并成为：
~~~
{defined name="NAME"}
NAME常量已经定义
{else /}
NAME常量未定义
{/defined}
~~~
# 原生PHP
Php代码可以和标签在模板文件中混合使用，可以在模板文件里面书写任意的PHP语句代码 ，包括下面两种方式：
## 使用php标签
例如：
~~~
{php}echo 'Hello,world!';{/php}
~~~
我们建议需要使用PHP代码的时候尽量采用php标签，因为原生的PHP语法可能会被配置禁用而导致解析错误。
## 使用原生php代码
~~~
<?php echo 'Hello,world!'; ?>
~~~
注意：php标签或者php代码里面就不能再使用标签（包括普通标签和XML标签）了，因此下面的几种方式都是无效的：
~~~
{php}{eq name='name'value='value'}value{/eq}{/php}
~~~
Php标签里面使用了`eq`标签，因此无效
~~~
{php}if( {$user} != 'ThinkPHP' ) echo 'ThinkPHP' ;{/php}
~~~
Php标签里面使用了`{$user}`普通标签输出变量 ，因此无效。
~~~
{php}if( $user.name != 'ThinkPHP' ) echo 'ThinkPHP' ;{/php}
~~~
Php标签里面使用了`$user.name`点语法变量输出 ，因此无效。
> 简而言之，在PHP标签里面不能再使用PHP本身不支持的代码。
# 定义标签
## ASSIGN标签
ASSIGN标签用于在模板文件中定义变量，用法如下：
~~~
{assign name="var" value="123" /}
~~~
在运行模板的时候，赋值了一个`var`的变量，值是`123`。
name属性支持系统变量，例如：
~~~
{assign name="Think.get.id" value="123" /}
~~~
表示在模板中给`$_GET['id']`赋值了`123`
value属性也支持变量，例如：
~~~
{assign name="var" value="$val" /}
~~~
或者直接把系统变量赋值给var变量，例如：
~~~
{assign name="var" value="$Think.get.name" /}
~~~
相当于，执行了：`$var = $_GET['name'];`
## DEFINE标签
DEFINE标签用于中模板中定义常量，用法如下：
~~~
{define name="MY_DEFINE_NAME" value="3" /}
~~~
在运行模板的时候，就会定义一个`MY_DEFINE_NAME`的常量。
value属性可以支持变量（包括系统变量），例如：
~~~
{define name="MY_DEFINE_NAME" value="$name" /}
~~~
或者
~~~
{define name="MY_DEFINE_NAME" value="$Think.get.name" /}
~~~
