升级指导 · ThinkPHP5.0完全开发手册

# 升级指导 [TOC=2,2] ## 从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 >[danger] 如果你使用了闭包查询条件，并且使用了默认的查询缓存`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`。 >[danger] 升级完成后请务必清空下数据缓存。 ## 从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方法使用子查询的情况，请尽量使用数组方式： >[info] ['子查询'=>'别名'] ## 从V5.0.1升级到V5.0.2 从`V5.0.1`升级到`V5.0.2`需要注意如下事项：下列模型属性和方法由原来的静态（static）定义改为动态定义： * 聚合模型的`relationModel`属性 * Model类的`useGlobalScope` 属性 * 软删除属性 `deleteTime`属性 * 全局查询范围方法`base`改为动态方法原来的`join`方法和`view`方法的第一个参数规范化，支持下面三种用法： >[info]#### 用法一：[ '带前缀表名'=>'别名' ] >#### 用法二：'带前缀表名别名' >#### 用法三：'不带前缀的表名' 如果有其它用法注意调整，下面的用法不再支持： >[info] #### '不带前缀表名别名' 如果使用了空操作方法，无需给`_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参数支持传入空字符串，则不做任何处理 >[danger]### 关键几点： > 默认模板目录全部是小写+下滑线规范； > 控制器类的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`版本的单字母函数对比如下： |`3.2`版本|`5.0`版本| |---|---| |C|config| |E|exception| |G|debug| |L|lang| |T|废除| |I|input| |N|废除| |D|model| |M|db| |A|controller| |R|action| |B|废除| |U|url| |W|widget| |S|cache| |F|废除|