宝塔PHP报“Call to undefined function”90%以上是扩展未装对、未启用或被disable_functions禁用：需确认函数对应扩展名、检查php.ini中extension=行是否正确添加（如extension=curl.so）、确保装到网站所用PHP版本、重载配置并重启php-fpm，同时排查系统依赖缺失及真实php.ini路径。
宝塔面板里 PHP 报 Uncaught Error: Call to undefined function，90% 以上是扩展没装对、没启用、或被禁用——不是代码写错了，别急着改逻辑。
确认函数归属的扩展名
报错里的函数名（比如 curl_init、mb_strlen、imagettftext）必须先对应到具体扩展。PHP 官方文档查函数页最准，但更快的办法是：
- 在终端执行
/www/server/php/81/bin/php -r "print_r(get_defined_functions()['internal']);"（把81换成你实际用的版本号），搜函数名，看它是否出现在输出里 - 若不在列表中，说明该函数根本没加载；若在但报错，大概率是
disable_functions干的 - 常见映射：
json_encode→json扩展（通常默认启用）、redis_connect→redis扩展、swoole_http_server→swoole扩展
检查 disable_functions 是否禁用了该函数
即使扩展已启用，函数也可能被 disable_functions 明确拉黑。宝塔里这个配置藏得深：
- 进网站 → 设置 → PHP 版本 → 配置文件，搜索
disable_functions - 注意它是一整行逗号分隔的字符串，比如
disable_functions = exec,passthru,shell_exec,system，如果报错函数（如symlink）出现在其中，直接删掉它，保留前后逗号格式 - 删完必须点“重载配置”，否则不生效；PHP 8.4 默认禁用更多函数，这点比老版本更敏感
验证扩展是否真正加载成功
宝塔界面上显示“已安装”≠扩展已启用。关键动作有三个：
立即学习“PHP免费学习笔记（深入）”；
- 进“软件商店 → PHP → 对应版本 → 设置 → 安装扩展”，确认你装的是网站当前使用的那个 PHP 版本（比如网站用 PHP 7.4，就别在 PHP 8.1 页面点安装）
- 装完后，手动打开配置文件，搜索
extension=，确认存在形如extension=curl.so的行（不是extension=curl）；像redis、swoole这类扩展，宝塔从不自动加这行 - 最后一步最容易漏：光“重载配置”不够，必须重启
php-fpm进程（宝塔面板里点“服务”→“重启”），否则phpinfo()和php -m都看不到新扩展
排查系统级依赖缺失导致扩展编译失败
某些扩展（如 imagick、gd、sodium）安装时看似成功，实则静默失败——因为缺底层系统库。
- 查日志最直接：运行
cat /www/server/php/81/var/log/install.log | grep -i "error\|fail"（路径中81换成你的版本） - 常见缺失项：
libjpeg-dev（GD）、libmagickwand-dev（Imagick）、libsodium-dev（Sodium）；Ubuntu/Debian 系统建议先跑apt update && apt install -y build-essential autoconf libtool pkg-config - 宝塔“软件商店 → 系统工具 → 安装常用依赖”只能覆盖一部分，不能替代手动确认
最常被跳过的环节是：确认 PHP 进程实际加载的 php.ini 路径。用 /www/server/php/81/bin/php --ini 查真实配置文件位置，别只信宝塔界面显示的“配置文件”链接——它有时会指向错误的版本目录。
