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）顶部插入调试代码：
立即学习“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() 仍会返回空 —— 这时候得进容器手动补依赖再重编。
评论(0)