TP5自定义函数必须定义在application/common.php中，裸露声明、无命名空间、非静态；命令行需手动引入，模板调用须显式传全参数。
TP5 的自定义函数不能直接“写脚本”执行，必须放在正确位置、符合加载规则，否则控制器、模板、命令行都调用不到。核心问题不是语法，而是加载时机和作用域。
自定义函数必须放 application/common.php
ThinkPHP 5.x 不支持在任意 PHP 文件里写函数然后全局调用。所有非类方法的自定义函数，必须定义在 application/common.php 中，且满足：
- 不能包裹在
namespace或任何类里 - 不能是
static、private、protected - 必须是裸露的
function xxx() { ... } - 该文件由框架自动引入（在应用初始化早期），所以函数才能被全局识别
比如你要加一个获取客户端 IP 的函数，就直接写在 application/common.php 末尾：
function get_client_ip() {
if (isset($_SERVER['HTTP_X_FORWARDED_FOR'])) {
return $_SERVER['HTTP_X_FORWARDED_FOR'];
} elseif (isset($_SERVER['HTTP_CLIENT_IP'])) {
return $_SERVER['HTTP_CLIENT_IP'];
} else {
return $_SERVER['REMOTE_ADDR'];
}
}
命令行脚本里调用自定义函数要手动引入
TP5 的命令行（application/command/ 下的类）不自动加载 common.php。如果你在自定义命令中想用 get_client_ip() 这类函数，必须显式引入：
- 在命令类的
execute()方法开头加：include_once APP_PATH . 'common.php'; - 或者更稳妥地，在
configure()或execute()里用require_once引入绝对路径 - 注意：不能依赖自动加载，因为命令行入口走的是
console.php，不经过完整 HTTP 生命周期
否则会报错：Call to undefined function get_client_ip()
模板里用函数必须带参数占位符
在 ThinkPHP 模板（.html）中使用自定义函数，比如 {:my_str_replace('a','b',$str)}，必须注意：
- 函数名前不能加
$，也不能用php:前缀 - 所有参数都必须显式写出，不能省略 —— 即使函数定义了默认值，模板里也得传空字符串或
null - 错误写法：
{:my_str_replace('a','b')}（漏掉第三个参数，模板引擎解析失败） - 正确写法：
{:my_str_replace('a','b',$str)}或{:my_str_replace('a','b','')}
这是因为 TP5 模板编译器按逗号切分参数，不解析 PHP 函数签名，默认值逻辑在运行时才生效，而模板编译阶段已经固定了参数个数。
别把函数塞进控制器或模型文件
常见误操作：在 application/index/controller/Index.php 里写一个 function helper_xxx() { ... }，以为能在同控制器其他方法里调用。
- 这样写的函数只在该文件作用域内有效，其他控制器、模型、模板完全看不到
- 即使你在当前控制器里用
helper_xxx()，也会报undefined function - 真正复用的函数，只有一条路：进
application/common.php
如果只是单个控制器内部用，建议改用私有方法（private function xxx()），而不是全局函数。
最容易被忽略的是命令行环境——它不加载 common.php，也不走模板解析流程，所有函数都要自己拉进来。写完函数后，务必在控制器、命令、模板三处分别验证调用是否成功。
