ThinkPHP7中自定义函数未定义的常见原因：默认不自动加载全局函数文件，需手动引入或注册；废弃common.php自动载入机制；命名空间内函数调用须加反斜杠前缀；require_once路径错误或未在bootstrap.php中统一加载。
ThinkPHP7中自定义函数未定义的常见原因
ThinkPHP7默认不自动加载全局函数文件，所有自定义函数必须显式引入或注册到自动加载机制中，否则调用时直接报 Call to undefined function。这不是语法错误，而是框架加载策略导致的路径/时机问题。
自定义函数文件没被自动加载
TP7废弃了旧版的 common.php 全局函数自动载入机制，不再扫描或 require 任意“functions.php”类文件。即使你把 app/functions.php 放对位置，也不会被自动执行。
- 确认你没有误以为 TP7 仍支持
app/common.php或thinkphp/helper.php这类旧约定 - 若坚持用全局函数，需手动在
app/bootstrap.php或public/index.php开头处require_once你的函数文件 - 更推荐方式：将函数封装为服务类或使用
Helper类，通过容器绑定（如Container::getInstance()->bind('MyHelper', MyHelper::class)）
函数定义在命名空间内但调用时没加反斜杠
如果你在 app/helper/UrlHelper.php 中这样写：
namespace app\helper;
function build_url($path) { return '/'.$path; }
那么调用时不能直接写 build_url('home')，而必须用全限定名 \app\helper\build_url('home')，否则 PHP 会在当前命名空间（通常是 app\controller）下找，自然找不到。
立即学习“PHP免费学习笔记（深入）”；
- 检查函数定义前是否有
namespace声明 - 调用时加
\前缀是最简单解法；或在调用文件顶部加use function app\helper\build_url; - 注意：TP7 的控制器、中间件等默认在
app\controller等命名空间下，不是全局作用域
函数文件路径错误或 require_once 失败
TP7 的自动加载基于 Composer PSR-4，只处理类，不处理纯函数文件。所以靠 require_once 引入时，路径错一点就彻底失效。
- 别用相对路径如
require_once 'functions.php'—— 当前工作目录不确定，容易失败 - 改用
require_once __DIR__ . '/../app/functions.php';或app_path('functions.php')（需先确保app_path()已定义或手动构造） - Linux 下严格区分大小写：
Functions.php≠functions.php，Windows 可能不报错但部署到生产环境必挂 - 加个兜底检查：
if (!function_exists('my_func')) { throw new \Exception('my_func not loaded'); }
最易被忽略的是：TP7 的生命周期中，bootstrap.php 是唯一稳妥的全局函数注入点；其他地方（比如中间件里 require）可能因请求流程跳过而失效。别图省事写在某个控制器里——那函数只对该控制器生效。
