变量输出

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

// 设置模板引擎参数
$config = [
	'view_path'	    =>	'./template/',
	'cache_path'	=>	'./runtime/',
	'view_suffix'   =>	'html',
];
$template = new \think\Template($config);
$template->fetch('hello', ['name' => 'ThinkPHP']);

hello.html模板文件中使用:Hello,{$name}!

模板编译后的结果就是:Hello,!

这样,运行的时候就会在模板中显示: Hello,ThinkPHP!

注意模板标签的{$之间不能有任何的空格,否则标签无效。所以,下面的标签

Hello,{ $name}!

将不会正常输出name变量,而是直接保持不变输出: Hello,{ $name}!

模板标签的变量输出根据变量类型有所区别,刚才我们输出的是字符串变量,如果是数组变量,

$data['name'] = 'ThinkPHP';
$data['email'] = 'thinkphp@qq.com';
$template->fetch('hello', ['data' => $data]);

那么,在模板中我们可以用下面的方式输出:

Name:{$data.name}
Email:{$data.email}

或者用下面的方式也是有效:

Name:{$data['name']}
Email:{$data['email']}

当我们要输出多维数组的时候,往往要采用后面一种方式。

如果data变量是一个对象(并且包含有nameemail两个属性),那么可以用下面的方式输出:

Name:{$data->name}
Email:{$data->email}

也可以直接调用对象的常量或者方法

常量:{$data::CONST_NAME}
方法:{$data->fun()}

使用默认值

我们可以给变量输出提供默认值,例如:

{$user.nickname|default="这家伙很懒,什么也没留下"}

系统变量输出

普通的模板变量需要首先赋值后才能在模板中输出,但是系统变量则不需要,可以直接在模板中输出,系统变量的输出通常以{$Request.(大小写一致) 打头,例如:

{$Request.server.script_name} // 输出$_SERVER['SCRIPT_NAME']变量
{$Request.session.user_id} // 输出$_SESSION['user_id']变量
{$Request.get.page} // 输出$_GET['page']变量
{$Request.cookie.name}  // 输出$_COOKIE['name']变量

支持输出 $_SERVER$_ENV$_POST$_GET$_REQUEST$_SESSION$_COOKIE变量。

如果在ThinkPHP6.0中使用的话,模板还支持直接输出Request请求对象的方法,用法如下:

$Request.方法名.参数

例如:

{$Request.param.name}

支持Request类的大部分方法,但只支持方法的第一个参数。

下面都是有效的输出:

// 调用Request对象的param方法 传入参数为name
{$Request.param.name}
// 调用Request对象的param方法 传入参数为user.nickname
{$Request.param.user.nickname}
// 调用Request对象的root方法
{$Request.root}
// 调用Request对象的root方法,并且传入参数true
{$Request.root.true}
// 调用Request对象的path方法
{$Request.path}
// 调用Request对象的module方法
{$Request.module}
// 调用Request对象的controller方法
{$Request.controller}
// 调用Request对象的action方法
{$Request.action}
// 调用Request对象的ext方法
{$Request.ext}
// 调用Request对象的host方法
{$Request.host}
// 调用Request对象的ip方法
{$Request.ip}
// 调用Request对象的header方法
{$Request.header.accept-encoding}

常量输出

还可以输出常量

{$Think.const.PHP_VERSION}

或者直接使用

{$Think.PHP_VERSION}

配置输出

仅用于输出ThinkPHP6.0+中的配置参数使用:

{$Think.config.app.app_host}
{$Think.config.session.name}

语言变量

仅用于输出ThinkPHP6.0+的语言变量使用:

{$Think.lang.page_error}
{$Think.lang.var_error}

扩展解析

可以自己扩展特殊的变量标签解析,使用

$template->extend('$Cms', function(array $vars) {
    return implode('.', $vars);
});

例如使用(注意严格区分大小写)

{$Cms.test.name}

会输出

test.name