thinkphp5模板变量赋值必须通过控制器的$this->assign()完成,支持单个赋值和数组批量赋值,且必须在fetch()前调用;模板中用{$key}取值,严格禁止空格,需用|raw输出html。

ThinkPHP5 模板变量赋值必须通过控制器完成,直接在模板里写 $name 不会生效,也不会报错——它就原样输出。
assign() 是唯一可靠的基础赋值方式
所有变量都得走 $this->assign() 才能进模板。它接受两种调用形式:
-
$this->assign('key', $value):单个变量赋值 -
$this->assign($array):批量传入关联数组,键即模板变量名
注意:$this->assign() 必须在 $this->fetch() 之前调用,否则变量丢失;而且它只传递显式指定的变量,不会把控制器里所有局部变量都塞进去——这是安全机制,不是 bug。
别误用 $this->key = $value 写法
虽然文档提过这种“快捷赋值”,但它有严重限制:
- 仅对当前控制器实例有效,不经过 assign 流程,部分模板引擎(如自定义驱动)可能不识别
- 无法链式调用,不能和
view()或with()混用 - 在 PHP 8.2+ 中触发
Deprecated: Creation of dynamic property警告
结论:除非你明确知道后果,否则一律用 $this->assign(),别图省事。
模板里怎么取值:语法、顺序、默认值
模板中变量必须用 {$key},且 { 和 $ 之间**绝对不能有空格**,否则变成纯文本。
支持多种取值方式:
- 普通变量:
{$name} - 数组元素:
{$user['email']}或{$user.email}(后者仅限一维索引/关联数组) - 对象属性:
{$obj->name} - 带默认值:
{$user.nickname|default="未设置"}
注意:{$Think.get.name} 这类系统变量是特例,不用 assign 就能用,但它们走的是全局输入层,不是控制器传参逻辑。
return 数组写法看似简洁,实则隐含陷阱
这种写法确实能跳过 assign():
<pre class="brush:php;toolbar:false;">public function index()
{
return ['title' => '首页', 'list' => $data];
}
但它等价于自动调用 $this->assign([...])
$this->fetch(),本质没变。问题在于:
- 无法在 return 前做条件判断后再决定是否赋某个变量
- 不能复用已有 assign 逻辑(比如基类里统一 assign 的用户信息)
- 调试时看不到中间 assign 过程,出问题难定位
真正复杂项目里,老老实实用 $this->assign() 更可控。所谓“简洁”,只是把逻辑藏起来了。
最易被忽略的一点:模板编译后生成的是 <?php echo htmlentities($name); ?>,所以所有输出默认 HTML 转义。如果你需要原样输出 HTML 字符串(比如富文本),得用 {$content|raw},否则会看到一堆 <p></p>。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











