ThinkPHP自定义TagLib类必须继承think\template\TagLib并实现tags属性，置于app\taglib\目录下、类名以TagLib结尾，模板中需用<load href="Xyz"/>加载后才能解析XML标签。
ThinkPHP 自定义 TagLib 类必须继承 think\template\TagLib
不继承这个基类，XML 标签根本不会被识别——框架在解析模板时只认它子类的实例。你写个空类、或继承 think\Model 之类，{:mytag} 就会原样输出，连报错都没有。
实操建议：
- 类名必须以
TagLib结尾（如TagLibXyz），且放在app\taglib\目录下（路径可配，但默认如此） - 命名空间需与目录结构一致，例如
app\taglib\Xyz.php对应namespace app\taglib; - 构造函数里不要做耗时操作，
TagLib实例是每次模板编译时临时创建的 - 必须实现
tags属性（数组），声明支持哪些 XML 标签，否则即使类存在也无标签可用
tags 数组里每个键值对决定 XML 标签是否被解析及如何转义
比如你写了 <my:if condition="xxx">...</my:if>，但 tags 里没定义 if，那整段 XML 就当普通文本输出，不会进解析流程。
常见错误现象：标签在模板里不生效、变量未替换、条件逻辑没执行——八成是 tags 漏配或 key 写错大小写。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
-
tags['if'] = ['attr' => 'condition', 'close' => 1]表示该标签支持condition属性、允许闭合 - 属性名必须小写，
Condition或CONDITION都不匹配 - 如果标签不闭合（如
<my:break/>），'close' => 0，否则解析器会等闭合标签，卡住 -
'level'可设为1强制进入嵌套解析，避免内层标签被忽略（比如自定义循环里再用volist）
XML 标签解析结果必须返回 PHP 字符串代码，不是 HTML
很多人以为 parseIf() 方法该返回 <div>xxx</div>，其实它要返回的是会被 eval() 执行的 PHP 代码片段，比如 echo $xxx; 或 if($condition){ ... }。
性能影响明显：返回错格式会导致模板编译失败，或者运行时报 Parse error；更隐蔽的是拼接字符串漏了分号、变量没加 $，错误只在模板实际渲染时暴露。
实操建议：
- 所有变量引用必须带
$，且使用$this->autoBuildVar()处理传入的表达式（如condition="name eq 'admin'"） - 避免直接拼接用户输入，
condition值需经$this->parseCondition()过滤，否则有代码注入风险 - 闭合标签的解析方法（如
parseIf和parseIfEnd）必须成对设计，parseIfEnd返回空字符串或仅}，别多写东西 - 调试时可在方法里
dump($content)看原始子内容，但上线前删掉，否则影响缓存和性能
模板中使用自定义标签前必须先 load，且 XML 命名空间要匹配类名
写了 TagLibXyz 类，模板里却写 <xyz:if> 报错？大概率是没 load，或命名空间写成了 my、custom 这类随意名字。
使用场景很具体：只有在开启了模板编译（默认开启）、且标签库被显式加载后，XML 才会走你的解析逻辑；否则直接跳过。
实操建议：
- 模板顶部加
<load href="Xyz"/>（注意不是xyz，首字母大写，对应类名TagLibXyz） - XML 标签前缀必须与
load的href一致，<Xyz:if>或<xyz:if>都行（TP 不区分大小写），但推荐统一用大写开头 - 如果用
extend加载多个，顺序会影响覆盖行为；同名标签后者覆盖前者，慎用 - 开发时关掉模板缓存（
'template_cache' => false），否则改了TagLib类也不生效
tags 数组声明和 load 的耦合关系——少一个环节，整个标签链就断了。 
