ThinkPHP部署需确保PHP扩展在CLI和Web环境均启用：pdo_mysql、mbstring、openssl、curl、json、ctype为必需，fileinfo和intl易失效需单独验证；安装后须重启PHP服务并用phpinfo()确认。
ThinkPHP部署时PHP扩展缺失，不是代码问题，是运行环境没配齐。核心要确认两点：该装的扩展是否真装上了，装上的是否在CLI和Web两个环境下都生效了。
先查清楚到底缺什么
ThinkPHP 6+ 最低依赖 pdo_mysql、mbstring、openssl、curl、json、ctype（PHP 8+），fileinfo 和 intl 在文件上传、国际化场景中也常被触发报错。别靠猜，用命令直接验证：
- 运行 php -m | grep -E "pdo|mbstring|openssl|curl|json|ctype|fileinfo|intl"，看输出里有没有这些关键词
- 再执行 php --ini，记下 Loaded Configuration File 路径——这是命令行用的 php.ini
- 如果走 PHP-FPM（比如 Nginx + FPM），用 ps aux | grep php-fpm 找出进程路径，再执行对应 php-fpm 的 --ini，拿到 Web 环境的配置路径
- 两个 php.ini 文件都要打开，逐行检查 extension= 行是否启用，路径是否正确
常见扩展安装方式
不同系统、不同部署方式，补装方法不一样：
- Ubuntu/Debian：sudo apt update && sudo apt install php-pdo php-mysql php-mbstring php-xml php-curl php-zip php-intl php-fileinfo
- CentOS/RHEL：sudo yum install php-pdo php-mysqlnd php-mbstring php-xml php-curl php-zip php-intl php-fileinfo
- Docker（官方镜像）：在 Dockerfile 中加 RUN docker-php-ext-install pdo mbstring opcache intl fileinfo；若需 Redis，再加 pecl install redis && docker-php-ext-enable redis
- Windows（phpstudy/xampp）：打开 php.ini，去掉 ;extension=php_pdo.dll、;extension=php_pdo_mysql.dll、;extension=php_mbstring.dll 前的分号；确认 extension_dir 指向的目录下真实存在这些 .dll 文件
特别注意 fileinfo 和 intl
这两个扩展容易“看似启用，实则失效”：
立即学习“PHP免费学习笔记（深入）”；
- fileinfo：有些 Linux 发行版默认不编译它。若 php -m 不显示，且 php.ini 里 extension=fileinfo 已启用，说明模块根本没编译进 PHP。需进入 PHP 源码 ext/fileinfo 目录，用 phpize + ./configure + make + make install 手动安装
- intl：依赖系统级 ICU 库。Debian/Ubuntu 要先 sudo apt install libicu-dev，CentOS/RHEL 要 sudo yum install libicu-devel；装完再启 extension=intl；最后用 php -i | grep "ICU version" 确认版本兼容（TP6+ 推荐 ICU ≥ 65.1）
- 二者都必须在 CLI 和 Web（FPM/Apache）两个环境中分别验证，改错一个就白忙
改完必须重启服务
扩展装好、php.ini 改完，不重启等于没做：
- PHP-FPM：sudo systemctl restart php-fpm 或 /etc/init.d/php-fpm reload
- Apache：sudo systemctl restart apache2
- Nginx + PHP-FPM：只需重启 php-fpm，Nginx 本身不用重启
- Windows 下用 phpstudy/xampp：点面板里的“重启服务”，不要只点“重启PHP”
- 改完务必访问 phpinfo() 页面，搜索扩展名，确认已加载；再刷新页面看 Loaded Configuration File 是否和你编辑的文件一致
