如何完成ThinkPHP5.0.24升级至ThinkPHP5.1版本迁移-ThinkPHP-PHP中文网

thinkphp 5.0.24 到 5.1 是不兼容升级，需重建应用骨架：更换目录结构、重写路由与控制器、调整模板命名规则、改用 db::raw() 处理 sql 表达式、更新配置与请求处理方式，并全面验证功能。

如何完成thinkphp5.0.24升级至thinkphp5.1版本迁移

ThinkPHP 5.0.24 到 5.1 的迁移不是简单替换，而是不兼容升级。官方明确说明：5.0 与 5.1 之间不支持无缝升级，必须按规范重构关键部分。直接覆盖或仅改版本号会导致路由失效、模板找不到、数据库查询报错甚至白屏。

以下为实际可行的迁移路径和关键操作点：

明确迁移前提与准备

确认 PHP 环境 ≥ 5.6（TP5.1 最低要求）
备份完整项目（含数据库、配置、runtime 目录）
不要复用原 application/ 目录结构——TP5.1 推荐标准目录为 app/（可保留但需调整命名空间与自动加载）
使用 Composer 初始化新 TP5.1 项目：
```
composer create-project topthink/think=5.1.* myapp
```
再逐步迁移业务代码，而非在旧项目上“升级”

btpanel phpsite 宝塔面板PHP网站
宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

路由与控制器适配

TP5.1 路由解析更严格，控制器命名与访问方式有变化：

控制器类名必须以 Controller 结尾（如 IndexController），且继承 think\Controller
方法名默认小写+下划线（如 helloWorld → 自动匹配 hello_world.html 模板）

route.php 中的数组式路由定义已废弃，改用闭包或链式注册：

// TP5.0.24（不推荐继续用）
return [
    'index' => ['index/index', ['method'=>'get']],
];

// TP5.1 正确写法（route/app.php）
use think\facade\Route;
Route::get('index', 'index/index');

模板与视图行为调整

view() 助手函数默认模板路径规则变更：从操作方法名直接转小写（helloWorld → helloworld.html），改为驼峰转下划线（→ hello_world.html）

若沿用旧模板名，需在控制器中显式指定：

return view('helloworld'); // 而非 rely on auto-resolve

fetch() 和 display() 的参数逻辑一致，但不再自动补全 .html 后缀（需手动加）

数据库与模型写法更新

查询条件中禁止使用裸字符串 exp，必须包裹 Db::raw()：

// 错误（TP5.0 兼容写法，TP5.1 报错）
$where['score'] = ['exp', 'score + 1'];
// 正确
$where['score'] = ['exp', Db::raw('score + 1')];
// 更推荐
Db::table('user')->exp('score', 'score + 1')->update();

exists 子查询必须用 Db::raw() 或专用方法：

$model->whereExists(Db::raw('SELECT * FROM user WHERE status = 0'))->select();

配置与请求处理差异

input() 函数不再支持动态 filter 参数拼接（如 input('name', '', 'htmlspecialchars,trim') 中的过滤链需预设或手动调用）
Request 对象取消对请求变量的写入能力（如 $request->param('name', 'abc') 不再可赋值），需改用 $request->only(['name']) 或直接取值后处理
日志驱动 Test 已移除，若配置了 'type' => 'test'，需替换为 'type' => 'file' 或关闭