thinkphp5自定义函数接收参数需遵循php原生规则：定义时明确参数名、引用符号、默认值；调用时严格按顺序传参，模板中用{:func($var)}语法且变量须由控制器assign()传入，不可在url()等函数中直接调用助手函数。
自定义函数定义时怎么接收参数
ThinkPHP5 的自定义函数本质就是 PHP 函数，传参方式完全遵循 PHP 规则，不因“在 TP5 里用”而改变。关键在于定义时明确参数名、是否引用、是否有默认值。
常见写法示例：
function format_price($price, $decimals = 2, $prefix = '¥') {
return $prefix . number_format((float)$price, $decimals, '.', '');
}
调用时：format_price(99.5, 0) → ¥99；format_price(123.456) → ¥123.46（自动用默认值）。
- 参数顺序必须严格匹配，除非用命名参数（PHP 8.0+，TP5 默认不依赖该特性）
- 不要在函数定义里写
input()或$this—— 自定义函数是独立作用域，没有控制器上下文 - 若需访问请求参数，必须显式传入，比如
format_price(input('price'), 1)
模板中用 {:xxx()} 调用时怎么传参
模板语法 {:xxx()} 是直接执行 PHP 表达式，所以传参和 PHP 原生调用一致，但要注意变量作用域和转义问题。
正确写法：
{:format_price($goods['price'], 1)}
错误写法（会报错或输出空）：
{:format_price($goods.price, 1)} // 模板里不能用 -> 或 [] 访问数组/对象属性（除非已开启严格模式且配置了对应解析器）
-
$goods['price']可用，$goods->price在默认模板引擎下不可用 - 字符串字面量要用单引号或双引号包裹，比如
{:get_client_ip()}不传参可直接写，但{:date('Y-m-d', $time)}必须确保$time已由控制器通过assign()传入 - 避免在
{:...}里写复杂逻辑，比如嵌套三元、循环——模板应专注展示，逻辑放函数或控制器
助手函数里怎么安全获取请求参数
自定义助手函数（如 app/common.php 或单独加载的 myhelper.php）无法直接访问 input()，因为 input() 是 TP5 的门面函数，依赖应用实例。硬调会报 Call to undefined function input()。
- 最稳妥方式：把需要的参数作为函数参数显式传入，例如
{:build_order_no($order_id, input('channel'))} - 次选方式：在函数内部手动读取超全局变量（不推荐），如
$_GET['id']或$_POST['name']，但绕过了 TP5 的过滤、验证、类型转换机制 - 绝对不要在助手函数里调用
\think\facade\Request::instance()或尝试重建应用上下文——破坏无状态原则，易引发并发或内存泄漏
分页或 URL 构建时带参调用函数的坑
很多人想在 url() 或分页 appends() 中“调用函数生成参数”，这是误解。URL 构建函数只接受原始值或数组，不执行 PHP 表达式。
错误示范：
{:url('index/detail', ['id' => get_real_id($id)])} // 模板编译阶段就报错，因为 get_real_id 未定义（作用域不对）
正确做法分两步：
- 控制器中先算好值：
$this->assign('real_id', get_real_id($id)); - 模板中直接使用：
{:url('index/detail', ['id' => $real_id])} - 分页携带参数用
$list->appends(['real_id' => $real_id])，而不是试图在render()里塞函数调用
真正容易被忽略的是：所有传给 url()、appends()、paginate() 的参数，都必须是控制器层已计算完毕的确定值，不是“待执行的表达式”。函数调用必须前置到 PHP 层完成。
