ThinkPHP版本与PHP版本必须严格匹配：TP3.2.x最低PHP5.3但不兼容7.0+；TP5.1需≥5.6.0但PHP8.0+有类型错误；TP6.x需≥7.1；TP8.1需≥8.0且不兼容7.x。
ThinkPHP 不是天然兼容所有旧版 PHP 的，是否能跑取决于你用的是哪个 ThinkPHP 版本、目标服务器的 PHP 版本，以及有没有动过底层类或用了被废弃的语法。
PHP 版本不匹配是最常见的“一上线就报错”原因，比如把 ThinkPHP 3.2.3 直接扔到 PHP 7.0+ 上，String.class.php 就会直接触发 Fatal error: Cannot use 'String' as class name —— 因为 String 在 PHP 7 中成了保留字。
查清自己用的 ThinkPHP 和 PHP 版本对得上吗
ThinkPHP 官方对 PHP 版本有明确底线要求，不是“能跑就行”，而是“低于就不支持”：
- ThinkPHP 3.2.x：官方最低支持 PHP 5.3，但 PHP 7.0+ 需手动改
String类、mysql_*函数等 - ThinkPHP 5.1：要求 PHP ≥ 5.6.0（但 PHP 8.0+ 会报
count(): Parameter must be an array or an object类型错误） - ThinkPHP 6.x：要求 PHP ≥ 7.1（6.3+ 推荐 ≥ 7.3；6.1.2 起已明确支持 PHP 8.2）
- ThinkPHP 8.1：要求 PHP ≥ 8.0，不兼容 PHP 7.x
php -v # 输出类似：PHP 7.4.33 (cli) (built: Oct 26 2023 10:12:00) ( NTS ) # 若项目是 TP8.1，这个版本就不行，必须升到 PHP 8.0+
如果版本明显不匹配，别硬扛——要么降 PHP（不推荐），要么升 ThinkPHP（推荐），或者做针对性修补（仅限维护老项目）。
TP3/TP5 升级到 PHP 7+ 必须处理的几个硬伤点
这些不是警告，是运行时必然崩溃的点，尤其在部署后第一次访问就炸：
立即学习“PHP免费学习笔记（深入）”；
-
String类名冲突（TP3.2.3）：必须重命名文件和类，如改为StringUtil.class.php，并全局替换use Org\Util\String;→use Org\Util\StringUtil; -
mysql<em>*</em>函数全被移除（PHP 7.0+）：需改用mysqli*或 PDO，并同步修改config/database.php中的'type' => 'mysql'→'type' => 'mysqli' -
create_function()被弃用（TP5.0 早期版）：报Deprecated: create_function() is deprecated，要替换成匿名函数或eval()（不推荐）+str_replace动态生成逻辑 -
each()函数被移除（TP5.1 某些扩展）：报Call to undefined function each()，需用foreach替代或打补丁
这些不是“可能出问题”，而是“只要加载到对应代码就挂”。别指望 error_reporting(0) 能压住——它们是 Parse Error 或 Fatal Error，连错误日志都未必写全。
用 Composer 管理版本时最容易忽略的兼容开关
很多人用 composer create-project 拉下项目后，本地 PHP 8.1 跑得好好的，一上 CentOS 7（默认 PHP 7.2）就报依赖冲突。这是因为 Composer 默认校验平台要求（platform-check），而你没告诉它“先别管 PHP 版本”。
- 临时绕过（仅限部署测试）：
composer install --ignore-platform-reqs - 但更稳妥的做法是在
composer.json中显式声明目标环境："config": { "platform": { "php": "7.2.34" } } - 这样
composer update就不会拉取只兼容 PHP 8.0+ 的包（比如新版topthink/think-orm）
注意：--ignore-platform-reqs 是把双刃剑——它可能让你装上一个根本跑不起来的扩展（比如依赖 mbstring 但系统没装），上线前务必在同环境验证 php -m | grep mbstring。
runtime 目录权限 + PATHINFO 配置是隐藏雷区
很多“兼容性问题”其实和框架无关，而是 Web 服务器没配对：
- Nginx 缺少
fastcgi_param PATH_INFO $fastcgi_path_info;→ ThinkPHP 的 URL 路由全 404（尤其是index.php/module/action这种 PATHINFO 模式） -
runtime/目录不可写 → 日志写不进、缓存生成失败、甚至白屏无报错（因为app_debug=false时错误直接吞掉） - SELinux 启用状态下，即使
chown nginx:nginx runtime也无效，得加上下文：sudo semanage fcontext -a -t httpd_sys_rw_content_t "/path/to/runtime(/.*)?"+restorecon -Rv /path/to/runtime
这些配置不报语法错误，也不进 PHP 错误日志，但会让整个应用处于“半瘫痪”状态——看着首页能打开，点个登录就 500，查日志却空空如也。
真正麻烦的从来不是“能不能升级”，而是“升级后哪几行代码会悄悄失效”。尤其是那些写在 Common/function.php 里、没人碰过十年的自定义函数，或者 Model 里手写的 mysql<em>query()</em>。建议上线前至少跑一次 php think clear + php -l 扫描所有 PHP 文件，再用 grep -r "mysql" app/ 这类命令做兜底排查。
