ThinkPHP标签库开发教程-ThinkPHP-PHP中文网

自定义标签不解析主因是taglib类未继承think\template\taglib、$tags未配全或未预加载；需确保命名空间与路径一致、类名以taglib结尾、$tags键全小写且闭合标识正确，parse方法返回可eval的php代码并过滤用户输入。

thinkphp标签库开发教程

自定义标签在模板里不解析、原样输出，基本就是 TagLib 类没继承对、$tags 没配全、或没预加载——不是语法写错，而是框架根本没认出这是个标签库。

TagLib类必须继承`think\template\TagLib`

不继承这个基类，XML 标签不会被识别。框架模板编译器只扫描 TagLib 子类实例，其他类（哪怕叫 MyTag、继承 Model 或空类）都会被跳过。

namespace 必须与文件路径一致，比如 app\taglib\Demo.php 对应 namespace app\taglib;
类名必须以 TagLib 结尾，如 DemoTagLib，否则自动加载机制找不到它
构造函数里别做数据库查询、文件读取等耗时操作，TagLib 实例是每次模板编译时临时创建的，影响缓存生成速度

`$tags` 数组漏配或大小写不匹配

$tags 是开关：没声明的标签，整段 XML 当纯文本输出，连 warning 都不报。

btpanel phpsite 宝塔面板PHP网站

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

下载

键名必须全小写，'If' 或 'IF' 都无效，<if condition="..."></if> 对应的 key 只能是 'if'
'close' => 1 表示闭合标签，'close' => 0 表示自闭合（如 {demo:time/}），设反会导致解析卡住或子内容丢失
需要嵌套解析（比如自定义标签里再用 {volist}），得加 'level' => 1，否则内层标签不进解析流程

parse 方法返回的不是 HTML，而是可执行 PHP 代码

很多人以为 parseTime() 该返回 <span>2026-05-15</span>，其实它要返回会被 eval() 执行的字符串，比如 <?php echo date('Y-m-d', $time); ?>。

所有变量必须带 $，拼接时漏掉（如写成 echo date('Y-m-d', time);）会导致运行时报 Parse error
用户传入的表达式（如 condition="status eq 1"）必须经 $this->parseCondition() 过滤，直接拼接有代码注入风险
闭合标签的 parseEnd 方法（如 parseIfEnd）只应返回 ?> 或空字符串，多写 HTML 或 <?php 会破坏上下文

模板中使用前必须显式加载或预加载

即使类存在、$tags 配对、方法也写了，模板里不加载就等于没写。

手动加载用 <taglib name="demo"></taglib>，注意 name 值是类名去掉 TagLib 后缀的小写形式（DemoTagLib → demo）
预加载更常用，在 config/template.php 中配置 'taglib_pre_load' => 'app\taglib\DemoTagLib'，路径必须带命名空间全称
预加载后模板中直接写 {demo:time/}，但若类在非默认路径（如 common\taglib），name 就不能简写，得用完整命名空间：<taglib name="app\common\taglib\DemoTagLib"></taglib>

最常被忽略的是 $tags 的 close 和 level 字段：一个设错，整个标签块失效；另一个没设，嵌套逻辑直接被跳过。调试时别只看模板输出，先 dump $content 确认子内容有没有传进来，再检查生成的缓存文件（runtime/view/xxx.php）里那段 PHP 是否语法合法。