ThinkPHP报“未定义函数”90%非框架问题，需先区分函数来源：PHP扩展函数（如curl_init）要查系统是否安装对应扩展包；自定义函数（如helper_func）须验证autoload.files配置及执行composer dump-autoload -o；第三方函数需核对包文档的autoload.files声明。
ThinkPHP 报“未定义函数”，90% 不是框架本身的问题，而是函数来源没找对、没装好、没加载上。关键得先分清：这个函数到底是 PHP 内置扩展提供的、你自己写的、还是第三方包带的。
一、先确认函数属于哪一类
看到报错里的函数名（比如 curl_init、helper_func、topthink\queue\job_dispatch），立刻做三件事：
- 运行
php -r "var_dump(function_exists('xxx'));"（把 xxx 换成报错函数名），看返回bool(true)还是bool(false) - 如果是 curl_init、mb_strlen、openssl_encrypt 这类，属于 PHP 扩展函数 —— 直接查系统是否装了对应扩展
- 如果是 helper_func、format_date 这种明显自定义的，重点查文件路径和 autoload 配置
- 如果是第三方包提供的（如 wechat_message），去翻包的
composer.json，看有没有"autoload": {"files": [...]}声明
二、PHP 扩展函数没启用？其实是根本没装
别急着改 php.ini。像 undefined function curl_init，大概率不是配置漏了 extension=curl，而是系统压根没装 php-curl 包。
- 运行
php -m | grep -i curl，没输出说明扩展没加载 - Ubuntu 用
dpkg -l | grep php-curl，CentOS 用yum list installed | grep php-curl，确认包是否存在 - Mac 用户 Homebrew 装完后，检查
php --ini输出的配置路径下是否有ext-curl.ini，内容应为extension="curl"（不是.so） - Windows 注意
php.ini里写的是extension=php_curl.dll，且extension_dir指向的目录下真有这个文件 - CLI 和 Web（Apache/FPM）可能用不同
php.ini：用phpinfo()页面查 “Loaded Configuration File”，再对比php -i | grep "Loaded Configuration File"
三、自定义函数或工具函数没加载？autoload.files 是关键
很多 helper 函数或扩展包提供的全局函数，靠的是 composer.json 里的 "autoload": {"files": ["helper.php"]} 来自动引入。一旦没生效，函数就彻底“隐身”。
立即学习“PHP免费学习笔记（深入）”；
- 确认你加的函数文件路径写对了，且在
composer.json的autoload.files里声明 - 改完
composer.json后，必须执行composer dump-autoload -o（加-o强制生成优化 classmap） - 检查入口文件
public/index.php是否正确引入了vendor/autoload.php - 如果函数定义在命名空间里（比如
namespace App\Helper;），调用时要用完全限定名\App\Helper\my_func()，或在文件顶部加use App\Helper\my_func;
四、其他常见但容易被忽略的情况
有些问题看着像函数未定义，其实卡在更基础的地方：
-
函数定义顺序错误：PHP 要求函数必须在调用前定义。如果写在
if里、或者放在调用语句后面，就会报错 -
拼写或大小写错误：PHP 函数名严格区分大小写，
HelperFunc()和helperfunc()是两个函数 - 文件没包含或路径不对：手动 require 的文件路径写错、文件名大小写不符（尤其 Linux 系统）、或用了相对路径但当前工作目录变了
-
PHP 版本不兼容：某些函数（如
str_contains）只在 PHP 8.0+ 提供，低版本会直接报未定义
