TP5中需通过config/template.php的function配置项注册自定义函数，键名为模板调用名，值为完整命名空间静态方法路径，如'my_format_date' => '\app\common\helper\Helper::my_format_date'，并注意清理模板缓存以生效。
TP5里怎么注册自定义函数到模板引擎
ThinkPHP 5 没有“函数签名”这个概念，你真正需要的是在模板中能直接调用的自定义函数——它本质是注册到 think\Template 的函数池里，不是 PHP 函数声明层面的签名。直接写个全局函数是没用的，模板引擎压根不认。
正确做法是通过 config/template.php 的 function 配置项注入：
return [
'function' => [
'my_format_date' => '\app\common\helper\format_date',
'is_vip' => '\app\common\helper\check_vip',
],
];
注意两点：键名（如 my_format_date）就是模板里用的名字；值必须是完整命名空间路径字符串，不能是闭包或函数数组。
为什么用静态方法而不是普通函数
TP5 模板函数注册机制只接受可调用字符串（is_callable($str, false) 为 true），而普通函数名（如 'format_date'）在开启命名空间后很可能找不到，尤其部署在子目录或 CLI 环境下容易报 Call to undefined function。
推荐统一放在 app/common/helper/ 下，用静态方法封装：
namespace app\common\helper;
class Helper
{
public static function my_format_date($time, $fmt = 'Y-m-d')
{
return date($fmt, is_numeric($time) ? $time : strtotime($time));
}
}
然后配置项写成：'my_format_date' => '\app\common\helper\Helper::my_format_date'。这样既避免命名冲突，又明确依赖边界。
模板里调用时参数传错会怎样
模板函数没有类型检查和参数校验，传错类型或漏参数不会报错，而是静默返回 null 或触发 PHP 警告（取决于 error_reporting 设置），最终页面可能显示空白或意外字符串。
安全写法是在 helper 方法里做基础兜底：
- 用
func_num_args()或func_get_args()判断实参个数 - 对关键参数用
is_numeric()、is_string()显式判断 - 默认值不要依赖 PHP 函数自身的默认行为（比如
date()的第二个参数为null会取当前时间，但模板里传空字符串就崩）
例如：my_format_date($time, $fmt = 'Y-m-d') 中，如果模板写成 {:my_format_date($vo.create_time)}，而 $vo.create_time 是 null，strtotime(null) 返回 false，date('Y-m-d', false) 就输出 1970-01-01 —— 这往往不是你想要的。
自定义函数无法热更新？缓存惹的祸
TP5 默认开启模板缓存，函数注册信息虽然写在配置里，但模板编译后的 PHP 文件里已经硬编码了函数调用逻辑。改了 helper 方法体，但没清缓存，旧逻辑照常执行。
开发阶段务必关掉缓存或手动清理：
- 临时关闭：
'cache' => false加到config/template.php - 清编译缓存：
php think clear --path=runtime/template/ - 或者直接删
runtime/template/目录
线上环境别关缓存，但上线前记得确认 helper 类已部署、模板缓存已刷新——这点最容易被忽略，问题现象就是“代码明明改了，模板还是老样子”。
