ThinkPHP 5.1 迁移至 8.0 是重写级迁移，非平滑升级：全局助手函数（input、cookie、config、dump等）全被移除，须分别替换为 Request/Component/Config/Debug 门面调用；Db::name() 废弃，改用 Db::table() 或模型；路由注解需显式配置扫描路径，中间件必须传完整命名空间类名。
ThinkPHP 5.1 迁移到 8.0 不是版本升级，而是框架重写级迁移。报错不是配置疏漏，而是底层机制彻底变更——函数被删、类名变、路由逻辑翻新、输出控制更严格。直接运行旧代码必炸，必须按模块逐项替换和验证。
函数不存在：全局助手函数全移除
报错如 Call to undefined function input()、cookie() not found，是因为 TP8.0 彻底删除了所有全局助手函数（input、cookie、session、config、lang、url、dump 等）。
-
input() → 改用
$this->request->param('name')（控制器内），或app('request')->param('name')（非控制器类）；注意input('post.name')要改写为$this->request->post('name') -
cookie()/session() → 改用组件调用：
$this->cookie->get('key')、$this->session->get('user') -
config() → 必须
use think\facade\Config;，再调用Config::get('app.debug')；运行时写配置（config('x', 'y')）已被禁止 -
dump() → 改为
use think\facade\Debug;后调用Debug::dump($data)；不可链式调用，Debug::dump($a)->dump($b)会报错
数据库操作报错：Db::name() 已废弃
报错如 Call to undefined method think\Db::name()，因 TP8.0 废弃表名映射方式，强制使用真实表名或模型。
PHP 8.5.12 RC 1
下载
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
-
Db::name('user')->where('id', 1)->find()→ 改为Db::table('user')->where('id', 1)->find()（注意传字符串 'user'，不能传类名） - 更推荐走模型：
app\model\User::where('id', 1)->find()；模型需继承think\Model，且字段必须与数据库一致（开启严格模式，字段缺失直接抛异常） - 若沿用 Db 类，请确认未混用 TP5.x 的查询构造器语法（如
field()参数顺序、order()多字段写法等）
路由 404 或注解不生效
访问路由返回 404，或 #[Route] 注解完全没反应，不是路径写错，而是扫描机制失效。
立即学习“PHP免费学习笔记（深入）”；
- 检查
config/annotation.php中'scan' => ['app\controller']是否存在；多模块（如app\admin\controller）必须显式加入该数组 - 闭包路由仍可用，但中间件注册方式变更：
->middleware('check')→ 必须写完整命名空间：->middleware(\app\middleware\Check::class) -
url('admin/index')失效，改用命名路由：Route::get('admin/dashboard', 'admin/Index/index')->name('admin.dashboard')，再调用url('admin.dashboard') - 确保已安装
topthink/think-annotation扩展，且未被composer remove误删
验证码空白、Session 丢失、图像乱码
这类问题本质是输出流程被破坏，而非功能开关没开。
-
验证码空白/小叉号：先查响应体是否含
或 PHP Warning —— 说明有 BOM 或前置输出；所有文件保存为 UTF-8 无 BOM；输出前加ob_clean(); header('Content-Type: image/png');并exit -
Session 丢失：检查
config/app.php中 session 配置是否为'type' => 'file'或有效驱动；确认think\middleware\SessionInit::class在中间件队列最前端；运行var_dump(session_status() === PHP_SESSION_ACTIVE)验证是否激活 -
图像类报 GD 缺失或字体路径错误：TP8.0 默认字体路径已变，需在 Captcha 配置中显式指定
'fontttf' => root_path('public') . 'font/arial.ttf'
