ThinkPHP中调用自定义函数需正确配置加载方式：一、通过common.php自动加载；二、用LOAD_EXT_FILE配置扩展文件；三、手动引入指定文件；四、分组函数库配置；五、验证函数是否存在。
如果您在ThinkPHP项目中需要调用自定义函数，但函数未被识别或报错“function not found”，则可能是函数库未正确配置或未按规范路径加载。以下是设置函数库引用的具体方法：
一、使用系统自动加载的common.php文件
该方式适用于项目全局通用函数，无需手动引入，框架会在初始化阶段自动加载。文件必须位于项目根目录下的Common目录中，且命名为common.php，系统将默认识别并载入其中所有函数。
1、确认项目目录结构中存在App/Common/common.php路径（ThinkPHP 3.x）或app/common.php（ThinkPHP 6.x）。
2、在common.php文件中以标准PHP函数语法定义函数，例如：function format_time($timestamp) { return date('Y-m-d H:i:s', $timestamp); }。
立即学习“PHP免费学习笔记（深入）”；
3、保存文件后，在任意控制器、模型或视图中可直接调用format_time(time())，无需额外引入语句。
二、通过LOAD_EXT_FILE配置扩展函数库
该方式用于管理多个非默认命名的函数文件，支持批量声明并全局可用，适合模块化函数组织，避免污染common.php主文件。
1、在项目配置文件Conf/config.php（3.x）或config/app.php（6.x）中添加配置项：'LOAD_EXT_FILE' => 'fc,one,helper'。
2、在App/Common/目录下创建对应文件，如fc.php、one.php、helper.php，每个文件内定义独立函数集。
3、确保各文件中函数名不重复，且未使用function_exists()包裹（除非需兼容多环境重复加载）。
4、修改配置后清除运行时缓存（删除Runtime/Data/_fields/与Runtime/Cache/下的全部内容），使新配置生效。
三、按需手动引入指定函数文件
该方式适用于低频调用、高耦合或仅限特定控制器使用的函数，可避免全局加载开销，提升运行效率。
1、在App/Common/目录下新建函数文件，例如tool.php，并定义函数function gen_order_id() { return 'ORD_'.uniqid(); }。
2、在目标控制器中使用load("@.tool");语句（ThinkPHP 3.x）或import('@.tool');（部分旧版）显式加载。
3、加载完成后即可直接调用gen_order_id()，该函数作用域仅限当前控制器上下文。
四、分组函数库配置（适用于模块化项目）
该方式面向启用分组（Group）结构的项目，允许为不同功能模块维护独立函数集合，实现逻辑隔离与职责分离。
1、确认项目已开启分组模式，并在Conf/config.php中配置'APP_GROUP_LIST' => 'admin,home,user'。
2、在App/Common/Admin/function.php路径下创建分组专属函数文件（以Admin分组为例）。
3、在该文件中定义仅限Admin模块使用的函数，例如function admin_log($msg) { file_put_contents(LOG_PATH.'admin.log', $msg.PHP_EOL, FILE_APPEND); }。
4、函数将在Admin分组下所有控制器执行前自动加载，其他分组不可访问该函数。
五、验证函数是否成功加载
该步骤用于快速定位加载失败原因，确保函数定义与调用路径完全匹配，排除因大小写、路径错误或缓存残留导致的问题。
1、在控制器中插入调试代码：var_dump(function_exists('your_function_name'));。
2、若返回bool(false)，检查函数文件是否位于正确路径、文件名是否拼写准确、函数名是否含非法字符。
3、若返回bool(true)但调用仍报错，检查是否存在同名函数重复定义，或是否在function_exists()条件外定义导致跳过。
4、使用get_defined_functions()['user']输出当前已定义的所有用户函数列表，确认目标函数出现在其中。
