ThinkPHP模板中|是框架自定义修饰符，非PHP原生语法，经编译为PHP函数调用；需注意参数顺序、命名空间函数须注册、避免资源依赖及全局状态函数，并优先在控制器处理逻辑。
模板里用|调用原生函数，本质是ThinkPHP的变量输出过滤机制
ThinkPHP模板中的竖线|不是PHP原生语法，而是框架自定义的变量修饰符解析规则。它背后走的是think\template\driver\php\TagLib和think\template\driver\php\Compiler的过滤链，最终把{$var|md5|date="Y-m-d"}这类写法编译成类似date("Y-m-d", md5($var))的PHP代码再执行。
这意味着：你写的函数必须能被PHP直接调用（不带命名空间、非静态方法需已实例化），且参数顺序严格按模板中出现位置传递——第一个参数永远是前面的变量值。
-
md5、htmlspecialchars、strtoupper这类单参函数可直接用，没问题 -
date、sprintf、substr等多参函数，必须用=显式传后续参数，例如{$time|date="Y-m-d H:i:s"}→ 编译后是date("Y-m-d H:i:s", $time) - 自定义函数如果带默认参数或可变参，模板里无法跳过前面参数，比如
str_replace不能只写替换后字符串，必须写全三参或用封装函数替代
哪些原生函数在模板里会“静默失败”或报错
不是所有PHP函数都能安全塞进|后面。常见翻车点集中在三类：
- 需要资源句柄的函数，如
fgets、mysqli_fetch_array——模板渲染时早已脱离数据库连接上下文，调用直接Warning: mysqli_fetch_array() expects parameter 1 to be mysqli_result - 依赖全局状态的函数，如
session_start、header——输出已开始，再调用会触发Cannot modify header information - 返回布尔值但没做空值判断的函数，如
empty、isset——它们本身不输出内容，模板里写{$var|empty}结果是空，不是false字符串，容易误判逻辑
更隐蔽的是json_encode：如果$var含中文且未设置JSON_UNESCAPED_UNICODE，模板输出会是乱码；但错误不会抛出，只会默默显示null或空字符串。
立即学习“PHP免费学习笔记（深入）”；
想用命名空间函数？得先注册进filter白名单
像Illuminate\Support\Str::slug或Carbon\Carbon::parse这种带命名空间的函数，默认不能用|直接调。ThinkPHP只认裸函数名，不认识\和::。
解决办法只有两个：
- 在应用初始化阶段（如
app\common\Bootstrap）调用think\facade\Template::filter()注册别名，例如：Template::filter('slug', [Str::class, 'slug'])，之后模板里就能写{$name|slug} - 写个无命名空间的封装函数，放在
app\common\helper.php里（确保被自动加载），比如function my_slug($str) { return \Illuminate\Support\Str::slug($str); }，然后模板用{$name|my_slug}
注意：注册的过滤器名不能和PHP原生函数重名，否则会被覆盖；也别用下划线开头，模板解析器会忽略。
性能和可维护性上，模板里调函数其实是个信号灯
每次用|调一个函数，都意味着这个逻辑本该在控制器或模型里处理完再传给模板。模板层做格式转换看似方便，但很快会出现重复逻辑、难以测试、改一处要搜全项目的问题。
- 比如
{$user.create_time|date="Y-m-d"}在5个模板里出现，哪天要改成带时区的格式，就得改5处 - 又比如
{$price|sprintf="%.2f"}，如果$price是null，sprintf直接警告，而你在模板里没法加?: 0兜底 - 更麻烦的是调试：错误堆栈指向的是编译后的缓存文件（如
runtime\html\*.php），不是你写的模板行号
真正该留在模板里的，只有最表层、无副作用、确定安全的转换，比如htmlspecialchars、nl2br、mb_substr。其余的，宁可多写一行$data['formatted_time'] = date('Y-m-d', $user['create_time']);，也比模板里堆|干净。
