TP5函数文件不支持自动加载，必须通过helper.php注册或composer autoload显式声明；直接放application/common.php因加载时机不可控、多模块不兼容及函数冲突风险而失效。
TP5 的函数文件（非类库）路径不支持自动加载，必须手动引入或统一注册到 helper.php 中，否则会报 Call to undefined function 错误。
为什么直接放 application/common.php 不生效
ThinkPHP5 默认只扫描 application/common.php 一次，且仅在应用初始化早期加载；但该文件本身不被框架“识别”为函数定义文件——它只是个普通 PHP 文件，若其中定义的函数在控制器/模型中被提前调用（比如在构造函数里），而此时 common.php 尚未执行，就会触发未定义函数错误。
-
common.php不是自动加载目标，它依赖框架启动顺序，不能保证在所有场景下先于业务代码执行 - 若项目启用了多模块（如
admin、api），common.php只在主模块加载，其他模块可能完全忽略它 - 函数名冲突风险高：多个
common.php（如各模块下自建）会导致重复定义 fatal error
正确做法：统一注册到 helper.php
TP5 支持通过 helper() 函数按需加载函数文件，推荐将所有自定义函数集中放在 application/extra/helper.php（或 application/common/helper.php），再在配置中声明入口。
- 创建
application/extra/helper.php，内容为纯函数定义，不包含命名空间或类 - 在
application/config.php中添加：'extra_config_list' => ['helper'] - 确保该文件返回一个数组，例如：
return ['my_format_date', 'array_to_tree'];（列出所有函数名） - 之后在任意地方调用
helper('my_format_date')即可载入并使用该函数 - 若想全局可用，可在
common.php末尾批量加载：helper(['my_format_date', 'array_to_tree']);
常见错误：把函数写进 extend/ 目录却没配 autoload
有人把函数文件丢进 extend/mytools/functions.php，然后指望 Composer 自动加载——这是无效的。Composer 只处理 PSR-4/PSR-0 类，不解析裸函数。
-
extend/是为第三方类库预留的，函数文件放这里不会被扫描 - 若坚持放
extend/，必须在composer.json的"autoload": {"files": [...]}中显式声明路径，例如："files": ["extend/mytools/functions.php"]，然后运行composer dump-autoload - 注意：该方式在 CLI 和 Web 环境下行为一致，但修改后必须重刷 autoload，容易漏掉
调试时快速验证函数是否已加载
遇到 Call to undefined function，别急着改路径，先确认函数是否真的被引入：
- 用
function_exists('your_function_name')检查运行时状态 - 在控制器开头加
dump(get_included_files());，看你的函数文件是否出现在列表中 - 检查函数文件是否有语法错误（比如末尾少分号），会导致整个文件加载失败且无提示
- 避免在函数内直接使用
$this或self::——函数不是类方法，没有上下文对象
路径本身不是核心问题，关键在于加载时机和作用域。TP5 对函数文件没有“路径配置”概念，只有“如何确保它在需要时已被执行”的实操逻辑。漏掉 helper() 调用或 autoload 声明，哪怕路径再对也白搭。
