class not found或call to undefined function报错大概率因php扩展未加载，需用php -m和extension_loaded()检查pdo_mysql、gd、mbstring、curl等是否启用，并注意cli与web环境php.ini差异及宝塔扩展配置冲突。
ThinkPHP 启动报错“Class not found”或“Call to undefined function”，大概率不是框架本身坏了，而是它依赖的某个 PHP 扩展根本没加载——比如 pdo_mysql、gd、mbstring、curl 这几个最常踩坑。别急着重装框架，先确认扩展到底在不在。
用 php -m 和 extension_loaded() 快速定位缺失项
ThinkPHP 5.1+ 和 6.x 的核心逻辑会主动检测扩展是否存在，但错误提示往往藏在日志里，前端只显示白屏或 500。最直接的办法是进终端跑两行命令：
-
php -m | grep -E 'pdo|gd|mbstring|curl|xml'—— 看 CLI 环境有没有启用 -
php -r "var_dump(extension_loaded('pdo_mysql'));"—— 单独验证某个扩展是否真被加载
注意：CLI 和 Web（如 Nginx + PHP-FPM）可能用不同 php.ini，php -m 只反映命令行状态；如果网页打不开但命令行能跑 TP 命令，说明 Web 环境的扩展没启。
在 ThinkPHP 里加一行代码，看它到底卡在哪
TP5/6 启动时会自动检查关键扩展，但不报具体缺哪个。你可以在入口文件（public/index.php）顶部插入调试代码：
if (!extension_loaded('pdo_mysql')) { die('pdo_mysql missing'); }
if (!extension_loaded('mbstring')) { die('mbstring missing'); }
if (!extension_loaded('gd')) { die('gd missing (required for captcha)'); }
这样启动就立刻暴露问题点。尤其注意 gd：验证码类（think\captcha\Captcha）在构造时调用 gd_info()，如果返回空数组或 ['version' => '']，就会直接抛异常，而不是静默降级。
宝塔面板用户特别注意扩展加载路径冲突
宝塔安装扩展后，常出现“面板显示已启用，但 php -m 没列出来”的情况，根源往往是 ini 文件加载顺序混乱：
- 宝塔把扩展配置写进
/www/server/php/80/etc/php.d/redis.ini这类独立文件，而你又手动在主php.ini里加了extension=redis.so - 结果 PHP 启动时报
Unable to load dynamic library 'redis.so'—— 实际是重复加载导致符号冲突 - 查清加载了哪些 ini：
php --ini，再扫一遍：grep extension /www/server/php/80/etc/php.d/*.ini
删掉重复项，再执行 sudo systemctl restart php80-fpm（注意对应版本号），别只点面板上的“重载配置”。
ThinkPHP 版本差异带来的扩展依赖陷阱
TP6 默认开启长连接和强制字符集声明，对 pdo_mysql 的底层调用更激进；TP5.1 则相对宽松。但两者都绕不开这几个硬依赖：
-
pdo+pdo_mysql：数据库驱动基石，缺一不可 -
mbstring：URL 路由解析、中文文件名、多字节字符串处理全靠它，TP6 报 “Route not found” 有时就是它没开 -
openssl或hash：Session 加密、Token 签名、缓存 Key 生成都会用到，禁用后可能表现为登录态丢失或验证码刷新失败 -
json：虽然 PHP 5.2+ 内置，但如果 php.ini 里写了;extension=json，它也会被关掉 —— TP 的配置解析器依赖json_decode()
最容易被忽略的是：某些 Docker 镜像（如 php:8.2-apache）默认不带 gd，即使你装了 php8.2-gd 包，若编译时没装 libfreetype6-dev，gd_info() 仍会返回空 —— 这时候得进容器手动补依赖再重编。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
