thinkphp5.0项目不可直接升6.0，必须经5.1中转但存在三重嵌套不兼容：5.0→5.1有路由参数与钩子变更，5.1→6.0则是架构级断裂——目录、命名空间、配置、事件全部重构，任一环节跳过即引发class not found、path_info为空、伪静态404连发。
ThinkPHP5.0项目需经5.1中转再升至6.0时，必须避开三重嵌套式不兼容：5.0→5.1存在路由参数解析变更与钩子命名调整，5.1→6.0则是架构级断裂——目录结构、命名空间、配置加载、事件注册全部重构，任意一环跳过或误判都会导致Class not found、PATH_INFO为空、伪静态404连发。
先确认能否走5.1中转路径
这一步不能省：TP5.0直接升6.0不可行，但5.0→5.1→6.0也非安全通道。若你的5.0项目使用了extend/目录下的自定义类、或依赖5.0特有的url_route_must=>false绕过机制、或大量使用$this->assign()混写模板变量与控制器逻辑，【请立刻停止升级流程，改用新建TP6项目+人工迁移业务代码】。因为5.0到5.1的升级手册里明确标注：5.0.24之前版本无法保证升级后路由兼容性，而5.1.30是最后一个修复RCE漏洞的版本，低于它已无补丁支持。
检查当前版本：在项目根目录运行php think version，输出为5.0.x且x＜24，则跳过本教程，直接备份后重建。
5.0升5.1必须完成的四件事
第一步：替换核心文件并清空Runtime
下载官方5.1.38完整包，仅覆盖thinkphp/目录（勿动application/），然后手动删除Runtime/全部内容——TP5.0的Runtime/Cache/结构与5.1不兼容，残留会导致模板编译失败。
第二步：修正URL参数获取方式
5.0中$request->param('id')在5.1里默认只取GET/POST混合参数，若原逻辑依赖$_GET优先，需显式改为$request->get('id')；否则接口返回空值却无报错，排查极耗时。
第三步：重写钩子绑定语法
5.0写法：Hook::add('app_init', 'app\behavior\CheckAuth')；5.1要求改用数组注册：Hook::add(['app_init' => 'app\behavior\CheckAuth'])。漏改会导致行为类完全不执行，权限校验形同虚设。
第四步：关闭5.0遗留的危险配置
检查application/config.php中是否还存在'url_param_type'=>1或'url_route_must'=>false，这两项在5.1中虽未移除但已触发CVE-2024-48112的利用链前置条件，必须删掉或设为true。
5.1升6.0的致命断点操作
方法一：环境与依赖强校验（必须最先做）
运行php -v确认≥7.1.0；执行php -m | grep -E "mbstring|json|openssl|fileinfo"，缺任一扩展则TP6启动即Fatal error——特别是fileinfo，PHP 8.2+下缺失会导致上传类报Mime\Type not found，错误堆栈不提示缺失扩展。
方法二：目录迁移不可直拷（关键易错）
把原5.1的application/index/controller/下所有控制器复制进TP6的app/controller/时，【必须同步修改命名空间为app\controller，且文件名首字母大写（如Index.php），类名也必须是class Index】；TP6严格遵循PSR-4，小写index.php或namespace app\index\controller会直接404，且错误日志不报命名空间问题。
方法三：配置文件拆分与.env接管（常被忽略）
将5.1的config.php大数组按功能切分成config/app.php、config/database.php等；在每份文件中，把数据库主机这类可变项替换成env('DB_HOST', '127.0.0.1')；然后在项目根目录新建.env文件，写入DB_HOST=192.168.1.100——若跳过此步，TP6会读取config/database.php里的硬编码localhost，而你测试环境实际连的是Docker内网地址。
伪静态与PATH_INFO修复验证
① 在宝塔面板中打开网站配置，确认location /块位于location ~ \.php$块之前；
② 找到PHP-FPM配置段，在fastcgi_params区域检查是否存在fastcgi_split_path_info ^(.+\.php)(/.+)$;和fastcgi_param PATH_INFO $fastcgi_path_info;两行，缺一则/index/index访问时$_SERVER['PATH_INFO']为空；
③ 进入站点设置→“网站目录”，将“运行目录”改为/public（TP6入口强制在此）；
④ 验证：访问一个不存在路径如/xyzabc，若返回Nginx默认404说明rewrite未生效，若返回TP6自带404页面说明已进框架；
⑤ 终极验证：在public/index.php第一行插入var_dump($_SERVER['PATH_INFO']);die;，访问/index/index，输出必须为/index/index，否则后续所有路由都失效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
