先说几个核心判断：在ThinkPHP中，自定义函数的定义位置非常容易出错，不同版本对应完全不同的路径规则。一旦放错位置，函数无法自动加载，调用时就会报出Call to undefined function错误，这是必须重视的问题。
下面我们按版本逐一说明，特别是TP6和TP3.x这两个主流版本，它们之间的路径规则差异巨大。
TP6 唯一合法路径：app/common.php
在ThinkPHP 6中，全局函数只有唯一的合法存放位置——app/common.php。这是框架自动扫描并加载全局函数文件的唯一入口，没有其他选择。
关键注意事项包括：
- 文件必须位于app/目录下，注意使用小写app，不能写成App或application，路径错误会导致框架无法识别。
- 文件名必须为common.php，不能使用_common.php、helper.php、functions.php等变体名称，框架只认这个文件名。
- 文件内禁止出现命名空间声明（
namespace），也不得使用use、return、exit、die等语句，否则可能引发加载异常。 - 定义函数时无需添加
if (!function_exists())包裹，因为该文件只会被加载一次，重复定义反而会报错。 - 每次修改文件后，务必执行
composer dump-autoload并清除缓存，例如运行php think clear:config，否则新函数可能无法生效。
TP6 多文件组织方式：app/common/ 目录
如果函数数量较多，全部塞进一个common.php文件会显得杂乱，此时可以拆分成多个文件。但需要注意，这些文件不会自动加载，需要手动引入。
具体操作步骤如下：
- 在app/common/目录下创建子文件，例如
string.php、date.php，每个文件只包含函数定义。 - 每个子文件内同样不能有namespace、class、return语句，规则与common.php相同。
- 最后，在app/common.php中通过
require_once手动引入这些子文件，框架加载common.php时会顺带加载它们。
这种方式的优点是可以按功能分类组织函数，便于维护，但需要开发者自行管理引入逻辑，操作上多了一步。
TP3.x 的常见路径：Common/common.php 或配置引入
TP3.x的机制更加灵活，不依赖固定路径，而是通过配置或显式引入来实现。不过，灵活性也意味着更容易出错，需要开发者自己把握好。
传统做法是将函数写在Application/Common/Common/function.php（注意大小写敏感），然后在配置中设置'LOAD_EXT_FILE' => array('function')，这样框架就会自动加载该文件。当然，也可以在控制器或模型中使用import('Common.Function');手动加载，或者通过include、require直接引入任意路径的函数文件。
简单来说，TP3.x提供了很大的自由度，但同时也要求开发者清楚自己在做什么，才能避免出错。
模板中调用函数的特别限制
无论函数定义在何处，在模板中调用时都有严格限制，不能像在PHP代码中那样直接写。
具体规则如下：
- 单参数函数：使用模板引擎标准语法
{$time|format_time}。 - 多参数函数：用
###占位原变量，例如{$text|truncate=20,###,'…'}，注意参数顺序必须固定，不能随意调整。 - 函数签名必须严格匹配：参数顺序不能错乱，不能使用引用传参（
&$var），函数必须有返回值，否则模板渲染时会出错。 - 函数体内不能使用
$this、app()、db()等——因为模板渲染时没有上下文，这些调用会直接报错。
这些限制初看有些繁琐，但理解了背后的原理后并不难掌握。毕竟，模板引擎的设计初衷就是保持简洁和隔离，避免在视图层混杂过多业务逻辑。
