TP8强制中间件handle()方法必须声明返回类型为\think\Response，否则反射失败且静默不执行；需实现MiddlewareInterface接口并用Auth::class注册，不可用字符串类名。
中间件 handle() 必须返回 \think\Response
TP8 强制要求所有中间件的 handle() 方法显式声明返回类型为 \think\Response，否则在 PHP 8.0+ 下反射失败，中间件静默不执行，无任何错误提示。
- 原 TP6 写法：
public function handle($request, \Closure $next) { return $next($request); }→ 在 TP8 中会跳过加载 - 正确写法：必须加
use think\contract\MiddlewareInterface;并实现接口，且handle()返回类型标注完整：public function handle($request, \Closure $next): \think\Response - 注册时不能用字符串，如
'app\middleware\Auth'，必须用app\middleware\Auth::class—— 否则 TP8 反射类时找不到handle()签名，直接忽略该中间件
响应对象不再自动转换，return $data 会报错
TP6 允许控制器中直接 return ['code' => 0]，框架内部自动包装成 Response；TP8 移除了这层隐式转换，所有控制器动作必须明确返回 \think\Response 实例。
- 常见错误现象：
Fatal error: Uncaught TypeError: ... must be an instance of think\Response - 修复方式：统一用
json()、view()、success()等助手方法，或手动 new：return response()->json(['code' => 0]); - 注意：自定义 JSON 响应头（如
X-Api-Version）必须调用header()或withHeader()，不能再靠全局输出缓冲
Db 查询结果不能直接 echo 或 foreach
TP8 的 Db::table()->select() 默认返回 Collection 对象（非数组），而 Db::name()->find() 返回 ?Model（可为空对象），直接 echo $user->name 在 PHP 8.1+ 下会触发 TypeError，因为未判断 $user 是否为 null。
PHP 8.5.12 RC 1
下载
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
- 必须显式判空：
if ($user && $user->name) { ... }，不能沿用 TP6 的if ($user->name) -
toArray()不再自动调用：模型查询后需手动加->toArray()才能得到数组，json()方法内部已处理，但自行json_encode()前务必先转 - 关联预载入改用
load()：原User::with('posts')->find(1)失效，必须拆成两步：$user = User::find(1); $user->load('posts');
路由返回值类型变更导致 JSON 响应头丢失
TP8 路由闭包或控制器方法若返回原始数组（如 return ['msg' => 'ok']），框架不再自动设 Content-Type: application/json，浏览器收到的是 text/html，前端 fetch().json() 直接抛错。
立即学习“PHP免费学习笔记（深入）”；
- 根本原因：TP8 响应生命周期更严格，返回值类型决定内容协商逻辑，原始数组被当作文本内容处理
- 推荐做法：一律用
json()辅助函数（return json(['msg' => 'ok']);），它会自动设置头、编码并返回Response对象 - 若需兼容旧 API 格式，可在
app/middleware.php中加全局中间件，统一拦截数组返回值并强制包装，但不如逐个修正来得稳定
Response 类型声明，就可能让整条链路降级为原始输出。 
