ThinkPHP各版本对PHP有严格版本要求：TP3.2需PHP5.4–5.6，TP5.0–5.1建议PHP7.1+，TP6.0需PHP7.1.0+（推荐7.3/7.4），TP8.0明确要求PHP8.0.2+；盲目升级PHP至8.2/8.3易因语法不兼容或扩展缺失导致解析错误、类加载失败或路由异常。
ThinkPHP 不是随便装个 PHP 就能跑，版本错一个，php -v 显示正常，composer create-project 直接报 Parse error: syntax error, unexpected '|' 或 Class "think\App" not found —— 这不是你代码写错了，是环境没对上。
ThinkPHP 各版本对应 PHP 的硬性门槛
别看框架名带“Think”，它对 PHP 解释器其实很“较真”。不是“能跑就行”，而是“不满足就拒载”：
-
ThinkPHP 3.2：只认PHP 5.4–5.6，用PHP 7.0+会立刻报Deprecated: mysql_connect()或直接Fatal error: Uncaught Error: Call to undefined function mysql_connect()—— 因为它依赖已移除的mysql扩展； -
ThinkPHP 5.0–5.1：最低要求PHP 5.4.0，但实际稳定运行需PHP 7.1+；注意：PHP 7.4+开始启用严格类型提示后，部分核心类加载失败，官方早已停止维护，生产环境请勿选用； -
ThinkPHP 6.0：强制PHP 7.1.0+，推荐PHP 7.3/7.4；PHP 8.0+下某些反射逻辑可能异常，除非你确认项目里没用到__callStatic或动态属性访问； -
ThinkPHP 8.0（当前开发中）：明确要求PHP 8.0.2+，依赖public string $name属性类型声明和string|int联合类型，PHP 7.4运行会直接报Parse error: syntax error, unexpected token "string"。
为什么别盲目追新？PHP 8.2/8.3 并不适合所有 TP 项目
PHP 8.2+ 引入了动态类名静态分析增强、readonly 属性、enum 等特性，听起来很酷，但 ThinkPHP 主干尚未全面适配这些语法的运行时约束。尤其当你用到第三方扩展（比如旧版 topthink/think-queue 或自定义命令行指令），容易触发：
-
Warning: Dynamic class names are not allowed in compile-time expressions（在think\console\Command继承链中常见）； -
TypeError: Return value of think\Container::make() must be an instance of think\Container, null returned（因 JIT 编译器对反射缓存处理差异）； - 本地
php think run正常，部署到 Nginx+PHP-FPM 后路由 404 —— 很可能是opcache.enable_cli=1在 CLI 模式下与 JIT 冲突。
实操建议：新项目起步，优先选 PHP 8.0.28 或 8.1.27（LTS 支持期长、TP 8 官方 CI 已覆盖）；老项目升级，先锁死 PHP 7.4.33，再逐模块验证。
立即学习“PHP免费学习笔记（深入）”；
Windows 下 phpstudy / XAMPP 用户最容易踩的坑
集成环境方便，但也藏了几个“静默陷阱”：
- phpstudy 切换 PHP 版本后，
phpinfo()显示的是 Apache 模块版本，但你在 CMD 里执行php -v调用的可能是系统 PATH 里的另一个 PHP —— 用where php（Windows）或which php（macOS/Linux）确认实际 CLI 版本； - XAMPP 自带的
php.ini默认关闭extension=php_openssl.dll和extension=php_fileinfo.dll，而ThinkPHP 6+初始化时就会因fileinfo缺失抛出RuntimeException: Unable to guess the mime type as no extension is provided； - phpstudy 的“网站根目录”必须指向
your_project/public，不是项目根目录；否则index.php入口无法加载自动加载器，报Class 'think\Container' not found—— 这和 PHP 版本无关，纯路径配置错误。
最常被忽略的一点：Composer 安装 ThinkPHP 时，composer create-project topthink/think 命令背后会读取当前 PHP 的 memory_limit 和 max_execution_time。如果这些值太小（比如默认 128M），vendor 安装中途会静默失败，只留下空文件夹。动手前先确认 php -r "echo ini_get('memory_limit');" 输出至少是 512M。
