如何检查ThinkPHP扩展未安装问题及依赖？

本文共计1010个文字，预计阅读时间需要5分钟。

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 启动时会自动检查关键扩展，但不报具体缺哪个。