如何在ThinkPHP中使用内置模板引擎输出变量_大括号标签与变量定界符-ThinkPHP-PHP中文网

thinkphp模板变量不渲染是因tpl_deny_php默认为true，禁用原生php代码；需改用{$var}语法或配置允许php代码。

如何在thinkphp中使用内置模板引擎输出变量_大括号标签与变量定界符

ThinkPHP模板里变量不渲染？检查`tpl_deny_php`和`template`配置

默认情况下，ThinkPHP 的内置模板引擎（ThinkTemplate）只允许使用 {\$var} 这类语法输出变量，不支持原生 PHP 代码。如果你写了 <?php echo \$name; ?> 却没报错但也不渲染，大概率是 tpl_deny_php 设为 true（默认值），它会直接过滤掉所有 <?php 标签——不是报错，而是静默丢弃。

更隐蔽的问题是：你改了配置却没生效。ThinkPHP 6 的模板配置在 config/template.php，但控制器里用 view() 渲染时，若手动传入了参数（比如 view('index', [], ['tpl_replace_string' => [...]])），会覆盖全局配置，导致定界符修改失效。

template.view_path 必须指向真实存在的目录，路径末尾不加斜杠；写成 ./template/ 或 template 都可能因相对路径解析失败而静默回退到默认路径
修改 template.tpl_begin 和 template.tpl_end 后，务必清空 runtime/view/ 下的缓存文件，否则旧编译结果仍按老定界符解析
ThinkPHP 5.1+ 不再支持 {literal}...{/literal} 之外的“关闭解析”语法，想混写 JS 模板字符串时，别用 { 开头的变量写法，改用 {:htmlspecialchars(\$data)} 或提前转义

想换掉`{\$xxx}`？修改`tpl_begin`/`tpl_end`要避开冲突字符

把变量定界符改成 [[\$xxx]] 看起来清爽，但实际容易翻车。ThinkTemplate 在编译阶段会逐字符扫描，一旦遇到 [[ 就开始匹配闭合，如果模板里有 Vue 的 v-for="item in list" 或正则字面量 /\[\[/，就会触发提前截断或解析错误，报 Parse error: syntax error, unexpected '[' 这类底层 PHP 错误。

真正安全的替换方案是用 ASCII 中不常用于前端语法的组合，比如 «\$xxx» 或 ~{\$xxx}~。注意：两个符号必须都设置，且不能包含空格、反斜杠、美元符本身。

template.tpl_begin 和 template.tpl_end 值必须为字符串，不能是数组或 null；设成 '' 会导致整个模板被当作纯文本输出
ThinkPHP 6.0.9+ 对定界符长度做了限制（最大 4 字符），超长会被截断，看似改了实则无效
如果项目同时用了 Twig 或 Blade 模板，切勿把定界符设成 {% 或 {{，ThinkTemplate 无法识别其语法结构，会直接报编译异常

输出变量时显示`{\$name}`原文？确认是否漏了`assign()`或变量名拼错

最常见的情况不是语法问题，而是变量根本没传进去。比如控制器写了 $this->assign('user_name', 'Tom')，模板里却写 {$name} —— ThinkTemplate 找不到 $name，就原样输出 {$name}，不会报 Notice。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

另一个坑是作用域：在 {volist name="list" id="vo"} 循环里，{\$vo.name} 可以，但 {\$list.0.name} 不行，因为 list 是父级变量，在循环体内不可直接索引访问。

使用 {\$Think.get.id} 读取 GET 参数时，确保 URL 确实带了 ?id=123，否则输出空字符串而非变量名
{\$Think.session.user_id} 在未开启 session 或未写入时，也静默为空，建议配合 {\$Think.session.user_id|default='guest'} 使用
变量名含下划线或大写字母时（如 {\$user_info}），确认控制器 assign 的键名完全一致；PHP 数组键区分大小写，assign('UserInfo', ...) 和 {\$userinfo} 不匹配

为什么`{\$data}`输出的是`Array`而不是内容？该用`{:print_r(\$data)}`还是`{\$data.name}`

ThinkPHP 模板对变量做“智能输出”：标量（string/int/bool）直接输出，数组和对象默认调用 var_export 并截断，所以看到 Array 是正常行为，不是 bug。真要调试，得用 {:print_r(\$data, true)}，但注意这会输出完整结构，线上环境务必删掉。

更关键的是语义：模板层不该承担数据扁平化逻辑。如果 \$data 是二维数组，应由控制器提前处理好，比如 \$this->assign('items', array_column(\$data, 'name'))，而不是在模板里写 {volist name="data" id="row"}{\$row.name}{/volist} —— 后者可读性差，且一旦 \$data 为空，{volist} 不会报错，但整个区块消失，排查困难。

{\$data|htmlspecialchars} 是安全输出 HTML 内容的正确姿势，不要写成 {:htmlspecialchars(\$data)}，后者绕过系统自动转义，存在 XSS 风险
日期格式化别用 {\$time|date='Y-m-d'}，ThinkPHP 6 已废弃该写法；改用 {\$time|date='Y-m-d'}（保持不变）或更推荐控制器里用 date('Y-m-d', \$time) 赋值
自定义函数（如 {\$text|md5}）要求函数必须是全局可调用的，不能是类方法或闭包，否则模板编译时报 Call to undefined function

定界符看着只是个符号，但它牵扯到模板编译、缓存生成、运行时解析三层机制。改之前先跑一遍 php think clear --runtime，改之后盯紧 runtime/log/ 里的 warning 日志——很多问题其实已经在那儿记着了，只是没人去看。