核心问题是php cli或web环境未启用必需扩展，需分别用php --ini和phpinfo()定位对应php.ini，取消extension=行注释并验证extension_loaded()返回true。
ThinkPHP安装时提示缺少PHP扩展，核心问题不是框架本身，而是当前PHP环境未满足运行条件。关键要分清是命令行（CLI）环境还是Web环境出问题，再针对性启用对应扩展。
先确认报错发生在哪个环境
安装过程中的报错来源不同，处理方式完全不同：
- 用composer create-project报错（如“ext-pdo is missing”），说明是PHP CLI环境缺扩展——查
php -m和php --ini - 安装成功后浏览器访问报“Class 'PDO' not found”或“系统不支持:mysql”，说明是Web环境（如Apache/Nginx+PHP-FPM）缺扩展——看
phpinfo()里的Loaded Configuration File - 两者显示不一致很常见，比如
php -m没看到pdo_mysql，但phpinfo()里有，就是CLI和Web用了两份php.ini
快速验证并启用关键扩展
ThinkPHP 5/6/8 都依赖几个基础扩展：pdo、pdo_mysql（或pdo_pgsql等）、mbstring、json、curl、openssl、fileinfo（TP8必需）。操作步骤统一：
- 运行
php --ini，找到CLI实际加载的php.ini路径；Web环境则建一个info.php写<?php phpinfo(); ?>，搜索“Loaded Configuration File” - 打开对应php.ini，搜索
extension=，确保以下几行前面没有分号：extension=mbstringextension=pdoextension=pdo_mysqlextension=fileinfo（TP8必须）extension=curlextension=opensslextension=json - 检查
extension_dir指向的目录是否存在，比如ext/下要有php_mbstring.dll（Windows）或mbstring.so（Linux/macOS） - 改完保存，重启Web服务（Apache/Nginx+PHP-FPM）；CLI端需关闭所有终端重开，再运行
php -m | grep -E "pdo|mbstring|fileinfo"确认
Windows常见坑与修复
Win10/Win11上特别容易踩中路径和版本混淆的坑：
- 执行
where php，如果输出多个路径，说明PATH里混了不同PHP版本——把你要用的PHP目录（如C:\php-8.2.5）移到系统环境变量PATH最前面 - XAMPP/WAMP用户：别只点控制面板“配置PHP”，要进对应PHP版本文件夹（如
F:\xampp\php\php.ini）手动改，改完重启Apache - phpEnv或绿色版PHP：确认
php.ini里extension_dir = "ext"，且ext\目录下确实有php_mbstring.dll等文件 - 哪怕
php -m看到mbstring，也务必运行php -r "var_dump(extension_loaded('mbstring'));"，输出bool(true)才算真正生效
Linux/macOS编译安装扩展的要点
如果用源码编译PHP，pdo_mysql这类扩展不是简单改php.ini就能启用的：
- 编译PHP时必须加
--enable-pdo --with-pdo-mysql，不能只写--with-pdo-mysql（否则PDO主扩展不会编译） - 确保系统已装MySQL开发包：
apt install libmysqlclient-dev（Ubuntu/Debian）或yum install mysql-devel（CentOS/RHEL） -
mysql_config命令必须可用，可用which mysql_config确认；若路径非标准，configure时写绝对路径：--with-pdo-mysql=/usr/bin/mysql_config - 编译完生成
modules/pdo_mysql.so，用php-config --extension-dir查准扩展目录，把so文件放进去，再在php.ini里写extension=pdo_mysql（不带.so）
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
