升级指导

从V5.0.23升级到V5.0.24

支持无缝升级

从V5.0.22升级到V5.0.23

支持无缝升级

从V5.0.21升级到V5.0.22

支持无缝升级

从V5.0.20升级到V5.0.21

支持无缝升级

从V5.0.19升级到V5.0.20

支持无缝升级

从V5.0.18升级到V5.0.19

支持无缝升级

从V5.0.17升级到V5.0.18

由于5.0.18+更具严谨性，如果数组查询条件中使用了exp查询，必须做出如下调整：

// 错误
$where['id'] = ['exp', '>score'];
$model->where($where)->find();
// 正确
$where['id'] = ['exp', Db::raw('>score')];
$model->where($where)->find();
// 正确 推荐写法
$model->whereExp('id', '>score')->find();

如果需要使用exp表达式更新数据，必须使用Db::raw()方法或者exp方法。下面用法不再支持：

// 错误 不再支持
$data['score'] = ['exp', 'score+1'];
$model->where('id', 1)->update($data);
// 正确
$data['score'] = Db::raw('score+1');
$model->where('id', 1)->update($data);
// 正确 推荐用法
$model->where('id', 1)->exp('score', 'score+1')->update();

从V5.0.16升级到V5.0.17

如果你使用了闭包查询条件，并且使用了默认的查询缓存cache()或者cache(true)，新版本会抛出异常，请使用cache('key')替代，避免因为查询缓存无效而影响业务。

如果你在order方法中使用了SQL函数，请使用orderRaw方法或者Db::raw()方法替代。

对于复杂的field/where/order字符串参数的，如果发现存在错误，尽量使用fieldRaw/whereRaw/orderRaw替代（只能传入字符串参数）。

从V5.0.15升级到V5.0.16

默认模板渲染规则改进

由于fetch方法和view函数的默认模板规则调整为操作方法的名称（不含操作后缀）转换为小写+下划线方式，而不是原来的直接把操作名称转小写。

举个例子，你的控制器操作方法名如果是helloWorld，之前版本使用：

$this->fetch();
// 或者
view();

渲染输出的时候会定位到 helloworld.html模板文件，而新版会自动定位到hello_world.html模板文件。

对于指定模板渲染的fetch方法和view助手函数不受影响，对于非驼峰操作方法名也没有影响。

从V5.0.14升级到V5.0.15

V5.0.14可以无缝升级到V5.0.15。

从V5.0.13升级到V5.0.14

V5.0.13可以无缝升级到V5.0.14。

从V5.0.12升级到V5.0.13

V5.0.12可以无缝升级到V5.0.13，如果使用了Redis缓存，需要清空下Redis缓存数据的内容。

从V5.0.11升级到V5.0.12

V5.0.11可以无缝升级到V5.0.12。

从V5.0.10升级到V5.0.11

V5.0.10可以无缝升级到V5.0.11。

升级完成后请务必清空下数据缓存。

从V5.0.9升级到V5.0.10

V5.0.9可以无缝升级到V5.0.10。

从V5.0.8升级到V5.0.9

V5.0.8可以无缝升级到V5.0.9。

从V5.0.7升级到V5.0.8

如果自定义了应用的命名空间的话，原来的app_namespace配置参数改为APP_NAMESPACE常量在入口文件中定义
如果使用了多对多关联，并且定义了中间表，那么中间表改为去掉前缀后的数据表名。

模型的scope方法之后只能使用数据库查询方法而不能使用模型的方法。

从V5.0.6升级到V5.0.7

V5.0.6可以无缝升级到V5.0.7。

从V5.0.5升级到V5.0.6

V5.0.5可以无缝升级到V5.0.6。

由于数据库缓存策略的改进，之前如果使用了数据缓存，请先清空下数据缓存。

之前因为升级到5.0.5版本后 时间字段使用整型后也会自动格式化输出的问题，现在可以设置数据库的配置参数 datetime_format值为false即可关闭自动转换。

另外，注意，如果使用了MongoDb数据库扩展的话，请删除数据库配置文件中的query参数。

从V5.0.4升级到V5.0.5

从V5.0.4升级到V5.0.5需要注意如下事项：

模型的时间日期字段会自动进行格式化输出，不需要进行额外处理。
原生查询不再支持返回数据集对象。
Connection类的model方法已经更改为getQuery。
关联定义方法的alias参数已经废弃。
分页查询返回类型变成think\Paginator（用法不变）。
数据缓存自动采用子目录方式避免缓存数据文件过多影响性能。
Session类添加了secure和httponly参数，并且默认是true，如果不支持请手动关闭。

从V5.0.3升级到V5.0.4

从V5.0.3升级到V5.0.4需要注意如下事项：

模型的关联定义方法必须采用驼峰法（小写字母打头）命名规范，但关联调用可以支持驼峰和小写方式。

行为类的方法必须使用驼峰法命名，如果你使用了钩子位作为行为执行方法入口，请修改为驼峰法，例如 app_init钩子位对应的行为方法名应该是 appInit。

如果你使用了Query类的fetchClass方法自定义数据集返回对象的话，请改为在模型中设置resultSetType属性，数据库类不再支持自定义查询数据集对象（只支持数组和系统的think\Collection数据集对象）

从V5.0.2升级到V5.0.3

从V5.0.2升级到V5.0.3需要注意如下事项：

对于join方法和view方法使用子查询的情况，请尽量使用数组方式：

['子查询'=>'别名']

从V5.0.1升级到V5.0.2

从V5.0.1升级到V5.0.2需要注意如下事项：

下列模型属性和方法由原来的静态（static）定义改为动态定义：

• 聚合模型的relationModel属性
• Model类的useGlobalScope 属性
• 软删除属性 deleteTime属性
• 全局查询范围方法base改为动态方法

原来的join方法和view方法的第一个参数规范化，支持下面三种用法：

用法一：[ '带前缀表名'=>'别名' ]

用法二：'带前缀表名 别名'

用法三：'不带前缀的表名'

如果有其它用法注意调整，下面的用法不再支持：

'不带前缀表名 别名'

如果使用了空操作方法，无需给_empty方法添加任何参数，当前操作名的获取直接使用请求对象的action函数获取。

从V5.0升级到V5.0.1

从V5.0升级到V5.0.1需要注意如下事项：

• 扩展配置参数extra_config_list废弃，除了数据库配置之外的扩展配置放入application/extra目录自动识别加载。
• 模型的field属性无需配置字段类型
• 查询构建器使用手动参数绑定的时候不要使用？号占位绑定，使用命名参数绑定
• 如果使用了file_get_contents('php://input')请改为Request对象的getInput() 方法获取
• 文件File类取消md5()和sha1()方法，请使用hash('md5')和hash('sha1')方法替代

从V5.0RC4升级到V5.0

可以轻松的从RC4版本升级到正式版，不过请注意如下事项：

• 如果定义了路由映射（静态路由）的则改为普通路由规则定义
• 定义了路由规则之后，原来的URL地址被禁止访问，请注意检查是否还有这种情况
• 如果配置了url_deny_suffix参数，改为路由的deny_ext参数设置
• 模型save方法返回值改为影响的记录数，并且方法参数中取消了getId参数
• Request对象controller方法返回驼峰控制器名，如果使用该方法渲染模板的话，请使用Loader::parseName(Request::instance()->controller())转换
• 如果使用了Sqlsrv驱动则，原来自动转换小写数据表字段默认不对数据表字段进行小写转换，请更改PDO::ATTR_CASE参数
• 如果部署在sae 需要使用sae扩展包
• 如果使用了Sqlsrv/Orace/Firebird驱动，则自行添加原来的驱动文件
• 配置参数读取的时候取消环境变量判断，需要读取环境变量的时候改用Env类
• 环境变量定义文件更改为 .env 由原来的PHP数组改为ini格式定义（支持数组方式）
• 状态配置和扩展配置的加载顺序调整 便于状态配置文件中可以更改扩展配置的参数
• 取消域名绑定到路由分组功能
• 控制器类的success和error方法url参数支持传入空字符串，则不做任何处理

关键几点：

默认模板目录全部是小写+下滑线规范；
控制器类的success、error和redirect方法无需使用return；
模型的save方法返回值更改为影响的记录数，而非主键，使用model->id方式获取主键；
路由定义后不能再使用原来URL地址访问；

从V3.2版本升级到V5.0

3.2版本无法直接升级到5.0版本，这里只是给出了升级指导思想和为了使用3.X版本的开发者更快的熟悉并上手这个全新的版本。同时也强烈建议开发者抛弃之前旧的思维模式，因为5.0是一个全新的颠覆重构版本。

需要摒弃的3.X旧思想

URL的变动

首先对3.X的不严谨给开发者们带来的不正确的引导表示歉意，在5.0版本正式废除类似/id/1方式 可以通过get获取到id的方法，严格来讲这样的url是不属于$_GET的，现在可以通过param获取，具体使用可以通过请求部分查询。

模型的变动

新版的模型查询返回默认对象，系统默认增加了toArray方法，许多开发者在all或select尝试使用toArray来转换为数组，在此希望开发者能理解对象的概念，尝试使用对象进行数据的使用，或者使用db方法进行数据库的操作，也提醒一下部分滥用toArray的开发者，all或select结果是对象的数组集合，是无法使用toArray进行转换的。

新版变化

命名规范

• 目录和文件名采用‘小写+下划线’，并且以小写字母开头；
• 类库、函数文件统一以.php为后缀；
• 类的文件名均以命名空间定义，并且命名空间的路径和类库文件所在路径一致（包括大小写）；
• 类名和类文件名保持一致，并统一采用驼峰法命名（首字母大写）

函数

• 系统已经不依赖任何函数，只是对常用的操作封装提供了助手函数；
• 单字母函数废弃，默认系统加载助手函数，具体参考上一个章节‘助手函数’；

路由

5.0的URL访问不再支持普通URL模式，路由也不支持正则路由定义，而是全部改为规则路由配合变量规则（正则定义）的方式，具体这里不再赘述。

控制器

控制器的命名空间有所调整，并且可以无需继承任何的控制器类。

• 应用类库的命名空间统一为app（可修改）而不是模块名；
• 控制器的类名默认不带Controller后缀，可以配置开启controller_suffix参数启用控制器类后缀；
• 控制器操作方法采用return方式返回数据，而非直接输出；
• 废除原来的操作前后置方法；

版本对比

3.2版本控制器写法

<?php
namespace Home\Controller;

use Think\Controller;

class IndexController extends Controller 
{
    public function hello()
    {
        echo 'hello,thinkphp!';
    }
}

5.0版本控制器写法

namespace app\index\controller;

class Index 
{
    public function index()
    {
        return 'hello,thinkphp!';
    }
}

3.2版本控制器命名

IndexController.class.php

5.0版本控制器命名

Index.php

怎么才能在控制器中正确的输出模板
5.0在控制器中输出模板，使用方法如下：
如果你继承think\Controller的话，可以使用：

return $this->fetch('index/hello');

如果你的控制器没有继承 think\Controller的话，使用：

return view('index/hello');

模型

如果非要对比与旧版本的改进，模型被分为数据库、模型、验证器三部分，分别对应M方法、模型、自动验证，同时均有所加强，下面做简单介绍。

数据库

5.0的数据库查询功能增强，原先需要通过模型才能使用的链式查询可以直接通过Db类调用，原来的M函数调用可以改用db函数，例如：
3.2版本

M('User')->where(['name'=>'thinkphp'])->find();

5.0版本

db('User')->where('name','thinkphp')->find();

模型

新版的模型查询增加了静态方法，例如：

User::get(1); 
User::all();
User::where('id','>',10)->find(); 

模型部分增强了很多功能，具体请查阅“模型章节”。

自动验证

对比旧的版本，可以理解为之前的自动验证且不同于之前的验证；
ThinkPHP5.0验证使用独立的\think\Validate类或者验证器进行验证，不仅适用于模型，在控制器也可直接调用，具体使用规则请参考“验证”章节，这里不再赘述。

配置文件

新版对配置很多的配置参数或者配置层次都和之前不同了，建议大家要么看看代码，要么仔细通读下官方的开发手册，不要因为配置的问题浪费自己一整天的时间。

异常

5.0对错误零容忍，默认情况下会对任何级别的错误抛出异常，并且重新设计了异常页面，展示了详尽的错误信息，便于调试。

系统常量的废弃

5.0版本相对于之前版本对系统变化进行了大量的废弃，用户如果有相关需求可以自行定义
下面是废除常量

REQUEST_METHOD IS_GET IS_POST IS_PUT IS_DELETE IS_AJAX __EXT__ COMMON_MODULE MODULE_NAME CONTROLLER_NAME ACTION_NAME APP_NAMESPACE APP_DEBUG MODULE_PATH等

部分常量可以在Request里面进行获取，具体参考“请求章节”。

再次说明本章节仅仅为之前使用3.X版本开发者快速理解5.0所写，具体5.0的功能还需要开发者通读手册。

助手函数

5.0助手函数和3.2版本的单字母函数对比如下：