必须确认php≥7.2.5且启用json、mbstring、xml、curl、openssl、pdo六个扩展，否则php think run或访问首页会报错；需用php -v和php -m验证cli环境，注意web与cli可能使用不同php.ini。
ThinkPHP6项目启动前必须确认PHP版本不低于7.2.5且核心扩展已启用，否则执行php think run或访问首页时会直接报错，如ext-mbstring missing或Parse error: syntax error, unexpected ':'——这些不是代码写错了，而是环境没达标。
检查PHP CLI版本是否达标
打开终端，直接运行：
php -v
输出第一行必须显示类似 PHP 7.2.5 或更高版本（如 8.0.30、8.1.22）。如果显示 7.1.33 或更低，【当前CLI环境不满足TP6最低要求】，不能继续安装或运行。
Windows用户特别注意：WAMP/XAMPP控制面板切换的PHP版本，不一定同步到命令行。务必在终端里执行php -v验证，而不是只看面板显示。
确认必需扩展是否全部启用
在终端中运行：
php -m | grep -E '^(json|mbstring|xml|curl|openssl|pdo)$'
必须看到全部6个模块名（大小写不敏感），缺一不可。少一个，TP6就无法完成自动加载或数据库连接。
若某项未出现（例如没看到mbstring），需手动编辑CLI环境使用的php.ini文件：
先运行php --ini查出加载路径 → 打开对应php.ini → 找到;extension=mbstring这一行 → 删除开头的分号 → 保存。
Linux/macOS用户若用包管理器安装PHP（如apt或brew），扩展可能未默认安装。例如Ubuntu需额外执行：sudo apt install php-mbstring php-xml php-curl php-sqlite3
区分Web与CLI两套PHP配置
第一步：运行php --ini，记录“Loaded Configuration File”路径；
第二步：在浏览器中新建info.php，内容为<?php phpinfo(); ?>，访问后搜索“Loaded Configuration File”；
第三步：对比两个路径是否一致。
不一致就说明Web服务器（如Apache）和命令行（Composer、think命令）用的是两套php.ini。TP6所有命令行操作（composer create-project、php think）只认CLI那套配置，【改Web端的php.ini对安装和命令执行完全无效】。
Windows下常见情况：WAMP的CLI配置文件在F:\wamp64\bin\php\php7.4.33\php.ini，而面板里修改的是Apache模块用的另一份。
快速验证环境是否就绪
方法一：进入项目根目录，运行php think env:check
（需先确保已安装topthink/think-env或自建命令类）
方法二：临时创建check.php，写入：<?php echo "PHP ".PHP_VERSION." ✅\n"; foreach(['json','mbstring','xml','curl','openssl','pdo'] as $e) { echo extension_loaded($e) ? "$e ✅\n" : "$e ❌\n"; } ?>
然后执行php check.php。
方法三：直接跑安装命令观察首屏反馈：composer create-project topthink/think tp6
如果开头几秒就报Your requirements could not be resolved，99%是PHP版本或扩展问题，不是网络或镜像问题。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
