## 任何 ThinkPHP5 核心框架版本升级一定要修改以下两处
**ThinkPHP5.0 正式版有一些不适合管理后台需求，做了如下修改，请务必修改下面所示**
>[info] **为了支持 include 标签引入文件模板自动定位，修改了文件 `thinkphp/library/think/Template.php` 的 `parseTemplateName` 方法：**
```
private function parseTemplateName($templateName)
{
$array = explode(',', $templateName);
$parseStr = '';
foreach ($array as $templateName) {
if (empty($templateName)) {
continue;
}
if (0 === strpos($templateName, '$')) {
//支持加载变量文件名
$templateName = $this->get(substr($templateName, 1));
}
// 解决模板 include 标签不支持自动定位当前控制器的问题
if (!preg_match("/(/|:)/", $templateName)) {
$templateName = str_replace(".", DS, thinkLoader::parseName(thinkRequest::instance()->controller())) . DS . $templateName;
}
$template = $this->parseTemplateFile($templateName);
if ($template) {
// 获取模板文件内容
$parseStr .= file_get_contents($template);
}
}
return $parseStr;
}
```
>[info] **为了支持多级控制器，`thinkUrl::build` 方法有bug，`thinkUrl::build("one.two.Three")` 会生成 `one.two._three` 的链接，正确的应该是 `one.two.three`，修改了文件 `thinkphp/library/think/Loader.php` 的 `parseName` 方法：**
**ThinkPHP 5.0.4及以上版本请按此修改：**
```
public static function parseName($name, $type = 0, $ucfirst = true)
{
if ($type) {
return preg_replace_callback(['/_([a-zA-Z])/', '/([^.][a-zA-Z]*$)/'], function ($match) use ($ucfirst) {
return $ucfirst ? ucfirst($match[1]) : lcfirst($match[1]);
}, $name);
} else {
return strtolower(preg_replace('/((?<=[a-z])(?=[A-Z]))/', '_', $name));
}
}
```
**ThinkPHP 5.0.3及以下版本请按此修改：**
```
public static function parseName($name, $type = 0)
{
if ($type) {
return preg_replace_callback(['/_([a-zA-Z])/', '/([^.][a-zA-Z]*$)/'], function ($match) {
return ucfirst($match[1]);
}, $name);
} else {
return strtolower(preg_replace('/((?<=[a-z])(?=[A-Z]))/', '_', $name));
}
}
```
## 从 v1.2 升级到 v1.3
### [ 代码自动生成 ]
现在支持删除已生成的代码，请勾选删除代码时谨慎操作，以免删除不该删除的代码而且不可恢复
### [ 节点管理 ]
节点管理变成三个大的区域，结构更清晰，在左上角的模块区域单击右键可以在模块下添加节点或者修改、删除模块，不选中任何右边主节点栏点击添加可以添加模块，选中某个节点可以在该节点下添加子节点或者修改该节点，点击左下角的分组可以切换分组，更直观
### [ 更直观的排序保存 ]
在列表页添加了快速排序，修改排序值后能直接保存排序
### [ 标签扩展 ]
针对快速排序保存拓展了一个排序保存菜单 `saveOrder`
### [ 邮件驱动 ]
邮件驱动更换为 [tp-mailer](https://github.com/yuan1994/tp-mailer)，一款非常优美、强大的邮件驱动，之前的配置文件不可用，之前的邮件驱动类也已删除，建议更换，具体看 [tp-mailer](https://github.com/yuan1994/tp-mailer) 文档
### [ 网站日志 ]
网站日志更强大，支持在应用内修改、删除、启动、停止日志记录，也更加规范了节点图，方便日后进行数据统计，同时修复网址日志多数组报错bug，之前的数据表全部不可用，请注意更换
### [ 模型和验证器路径 ]
模型路径由原来的 `admin` 模块下的 `model` 文件夹迁移到 `common` 的 `model` 文件夹下，如果不想此设计，请自己修改 `application/extra/app.php` 配置文件里的 `model_path` 和 `validate_path` ，此设计是为了大型项目跨模块使用模型更好的使用模型和模型关联特性
同时模型命名全部修改修改为驼峰式（CamelCase），一级控制器对应的模型不必修改，多级控制器对应的模型可以修改，但也兼容，不方便可以不用修改，以后注意规范即可
## 从 v1.1 升级到 v1.2
### [ 代码自动生成 ]
`v1.2` 版本已经废弃 `v1.1` 版的代码自动生成器，为了兼容终端模式，原来的代码自动生成器模型 `admin/model/genereate.php` 已经弃用，相关文件已经迁移至 `extend/Genereate.php`，其他文件路径不变，请将 `extend/Genereate.php`，`extend/console` 文件夹，`generate` 控制器和模板文件替换为 `v1.2` 版的文件
### [ 终端模式 ]
请将项目根目录的 `tpadmin`，`genereate.php`，`extend/console` 文件夹拷贝到 `v1.1` 项目中
### [ 节点管理 ]
原来的节点管理弃用，更换为基于 `zTree` 插件的节点树对节点管理，请替换节点管理 `AdminNode` 对应的控制器、模型、模板、逻辑层（logic）
### [ 标签扩展 ]
升级的标签库不影响以前的标签，可以直接替换文件 `admin/taglib/Tp.php`
### [ bug修复 ]
修复因 `Javascript` 代码错误导致的bug，请替换相关代码 `public/static/admin/js/app.js`
### [ 公共控制器Controller ]
`v1.2` 将 `v1.1` 中的 `datalist`，`filterId` 方法从 traits 迁移至 公共控制器中，同时增加了 `datalist` 方法返回值和是否开启分页功能
### [ 代码写法 ]
模板里将 `{:isset($vo.name)?$vo.name:''}` 写法简写为 `{$vo.name ?? ''}`，将 `{:\think\Request::instance()->param('name')}` 简写为 `{$Request.param.name}`，控制器过滤 `if` 条件判断将代码块写到 `{ }` 里了，比如
```
// 原来的写法
if ($this->request->param('name')) $map['name'] = ["like", "%" . $this->request->param('name') . "%"];
// 现在的写法
if ($this->request->param('name')) {
$map['name'] = ["like", "%" . $this->request->param('name') . "%"];
}
```
## 从 v1.0 升级到 v1.1
`v1.1` 是一个重构的版本，修改 `v1.0` 中很多代码不规范的地方，改动非常大，**无法兼容过渡**，最好升级后对代码进行大幅改动
