TP6 升级到 8.0 如何迁移旧版中间件代码兼容

TP6 升级到 8.0 核心在于 PHP 版本提升至 8.0+ 及中间件接口的严格类型规范。

先说结论：升级前务必确认服务器 PHP 版本满足 8.0+ 要求，旧版中间件逻辑可复用，但类定义需修正类型声明。

适合：PHP 8.0+ 环境及 TP8 核心框架
先准备：备份代码并检查自定义中间件接口
验收：通过日志确认请求链路无报错

环境检查与依赖更新

php -v
composer show topthink/framework

先通过命令行确认当前 PHP 版本，再查看框架版本依赖。如果 PHP 版本低于 8.0，代码层面的修改没有意义，必须先升级环境。

注意：执行 composer update 前务必备份代码和数据库，避免依赖冲突导致项目无法启动。

composer update topthink/framework

中间件代码迁移对比

ThinkPHP 8.0 强制严格类型声明，TP6 时期宽松的写法在 TP8 中可能会触发致命错误。以下是 handle 方法签名的典型差异：

TP6 旧版写法（可能存在风险）：

<?php
namespace app\middleware;

class CheckToken
{
    public function handle($request, \Closure $next)
    {
        // 缺少返回类型声明
        return $next($request);
    }
}

TP8 推荐写法（严格类型）：

<?php
declare(strict_types=1);

namespace app\middleware;

use think\Request;
use think\Response;
use Closure;

class CheckToken
{
    public function handle(Request $request, Closure $next): Response
    {
        // 必须明确返回 Response 对象
        return $next($request);
    }
}

重点修正：添加 declare(strict_types=1);，明确参数类型 Request 及返回类型 Response。

配置文件调整

检查 config/middleware.php 或 app/middleware.php，确认中间件注册路径是否变更。TP8 中建议直接使用类名全称或确保命名空间自动加载正确。

// config/middleware.php 示例
return [
    // 中间件执行顺序由数组顺序决定，优先级从上到下
    app\middleware\CheckToken::class,
];

若发现路由中间件未生效，检查路由定义中的中间件别名是否已在配置中映射。

验证与排查

访问一个受中间件保护的路由，观察响应状态码。如果返回 500，查看 runtime/log 下的错误日志。

重点搜索：

TypeError：类型声明不匹配
Namespace：类找不到或命名空间错误
Return value：中间件未返回 Response 对象

常见坑

1. 全局函数依赖：旧代码中可能大量使用 input()、session() 等 helper 函数，在严格模式下建议改用注入方式。

2. 会话处理：PHP 8 对 Session 处理机制有微调，确保中间件中的会话读写兼容新环境。

3. 异常捕获：TP8 的异常处理逻辑更规范，中间件内 try-catch 捕获的范围可能需要调整，避免吞掉框架级异常。