ThinkPHP 5.1 模板中调用自定义函数需显式注册到模板引擎函数池，否则静默失效；注册须在 app/common.php 或控制器中完成，调用时名称、大小写、语法（: 或 |）须严格匹配，函数必须返回值而非输出，且避免异常、未加载类及参数错误。
ThinkPHP 5.1 模板中调用自定义函数无响应，通常不是函数没写，而是函数未被正确注册、未被模板引擎识别或执行环境受限。核心问题集中在“怎么让模板认识并安全执行它”。
自定义函数必须显式注册才能在模板中使用
TP5.1 的模板引擎默认只支持内置助手函数（如 :captcha_img、:url、:date），所有自定义 PHP 函数都必须手动注册到模板引擎的函数池中，否则 {:my_func()} 或 {$var|my_func} 会静默失败（不报错、不输出、也不执行）。
注册方式有两种，缺一不可：
- 在
app/common.php（推荐）或app/tags.php中添加：\think\template\driver\File::config('function', [ 'my_format_time' => '\app\common\helper\TimeHelper::format', 'truncate' => '\app\common\helper\StringHelper::cut', 'ucfirst' => 'ucfirst', // 可直接映射原生函数 ]); - 或在模板渲染前（如控制器中）动态注册：
$this->view->engine->setFunction([ 'price_format' => function($price) { return '¥' . number_format($price, 2); } ]);
模板中调用语法必须匹配注册名
注册时用什么键名，模板里就用什么——大小写、下划线、驼峰必须完全一致：
立即学习“PHP免费学习笔记（深入）”；
- 注册为
'my_upper' => 'strtoupper'→ 模板中写{:my_upper('hello')}✅ - 注册为
'myUpper'→ 写{:my_upper()}❌（找不到，静默忽略） - 注册为
['my_helper']→ 写{$val|my_helper}✅，但{:my_helper()}会报错（因为|是过滤器语法，:是表达式语法，用途不同）
常见静默失效场景
- 函数体中有
echo/print/var_dump：模板函数应返回值，不能直接输出，否则破坏 HTML 流，可能造成页面截断或空白 - 函数抛出异常但未捕获：TP5.1 模板中异常默认被吞掉（尤其生产环境），表现为“无响应”，建议先在控制器里单独调用测试是否正常
- 使用了未加载的类或命名空间：如
'\app\service\Tool::doIt()'，但Tool类未被自动加载（检查命名空间、文件路径、composer dump-autoload） - 函数参数类型不匹配：比如注册的是
function($str, $len=10)，模板却传了{:my_cut($data)}，而$data是 null → 可能触发 warning 并终止执行（开发环境可见，生产环境静默）
过滤器写法（|）和表达式写法（:）不能混用
-
{$name|my_upper}→ 调用过滤器，作用于变量值，等价于my_upper($name) -
{:my_upper($name)}→ 执行表达式，可带任意逻辑，但需确保函数存在且可调用 - 错误示例：
{$name|my_upper('extra')}→ 语法非法，|后不接受参数，会解析失败且无提示
不复杂但容易忽略
