ThinkPHP模板中添加自定义PHP标签需三步：1. 在app\taglib\下创建继承think\template\TagLib的类，声明$tags并实现parse方法返回PHP代码；2. 模板顶部用显式加载；3. 以形式调用。
在 ThinkPHP 模板中添加自定义 PHP 标签，本质是通过 自定义 TagLib 类 实现标签解析，最终生成并执行 PHP 代码（不是直接写 PHP，而是由标签类的 parse 方法返回合法 PHP 字符串）。关键不在“写 PHP”，而在“注册标签库 + 正确声明 + 模板加载”。
1. 创建标签库类（必须继承、命名规范、路径固定）
类必须放在 app\taglib\ 目录下，文件名与类名严格一致，命名空间为 app\taglib，且必须继承 think\template\TagLib：
- 类名以
TagLib结尾，例如TagLibMy→ 文件名My.php - 重写
$tags属性，声明支持的标签名和属性，如：protected $tags = ['hello' => ['attr' => 'name', 'close' => 1]]; -
parse方法（或_hello风格方法）必须返回可执行的 PHP 代码字符串，不是 HTML。例如：return '<?php echo "Hello, " . $tag["name"] . "!"; ?>';
2. 模板中显式加载标签库（不能省略，位置很关键）
<taglib name="my"></taglib> 必须写在模板最顶部， 标签之前或紧贴其后：
-
name值必须与类名后缀一致：类是TagLibMy，这里就填my - 多个标签库用英文逗号分隔：
<taglib name="my,nav,auth"></taglib> - 即使配置了
taglib_pre_load，这行仍需保留——它只预加载类，不启用解析
3. 在模板中使用自定义标签
加载成功后，按命名空间规则调用：
立即学习“PHP免费学习笔记（深入）”；
- 如果类是
app\taglib\TagLibMy，模板中写<hello name="Tom"></hello> - 支持闭合/非闭合两种形式：
<script src="a.js"></script>（close=0）<loop data="$list">[item.name]</loop>（close=1） - 属性值会自动解析为变量，可在
parse方法中直接使用$tag['xxx']
4. 注意缓存与调试
开发阶段容易卡在这里：
- 开启模板缓存时，修改标签类后必须清空
runtime/cache/和runtime/log/下相关文件 - 报错
Class not found多因命名空间错误或文件路径不对；静默失效多因没写<taglib></taglib>或位置错了 - 建议先写一个最简
TagLibTest，只输出固定字符串，验证流程通了再加逻辑
