### 2018 年 11 月 5 日 发布
## 介绍
`5.2`版本的第一个`Beta1`测试版本发布,仅供学习和测试用途,暂时请不要用于实际项目。
>[danger] `5.2`的目标致力于提供一个更简洁、更标准的核心框架,对于一些非必须功能力求组件化或者通过扩展解决。
目前已经完成的主要特性包括:
* 基于PHP`7.1+`重构;
* 强类型严格约束;
* 完全依赖`composer`;
* 原生多应用支持;
* 支持应用的`Composer`引入;
* 引入事件系统;
* 增加`PSR-6`和`PSR-16`支持;
目前核心功能基于PHP`7.1`实现,未来的升级版本不排除要求PHP`7.2+`的可能性。
## 安装
~~~
composer create-project topthink/think tp5 5.2.*-dev
~~~
启动服务
~~~
cd tp5
php think run
~~~
然后就可以在浏览器中访问
~~~
http://localhost:8000
~~~
如果需要更新框架使用
~~~
composer update topthink/framework
~~~
## 目录结构
>[info] 相对于`5.1`来说,`5.2`版本目录结构的变化不大,主要是默认应用目录改为`app`,`thinkphp`目录不再放置根目录而是直接安装到`vendor`目录下。
~~~cmd
www WEB部署目录(或者子目录)
├─app 应用目录
│ ├─command.php 命令行定义文件
│ ├─common.php 公共函数文件
│ ├─event.php 事件定义文件
│ ├─controller 控制器目录
│ ├─model 模型目录
│ ├─view 视图目录
│ └─ ... 更多类库目录
├─config 应用配置目录
├─route 路由定义目录
├─public WEB目录(对外访问目录)
│ ├─index.php 入口文件
│ ├─router.php 快速测试文件
│ └─.htaccess 用于apache的重写
├─extend 扩展类库目录
├─runtime 应用的运行时目录
├─vendor 第三方类库目录(Composer依赖库)
├─composer.json composer 定义文件
├─LICENSE.txt 授权说明文件
├─README.md README 文件
├─think 命令行入口文件
~~~
>[danger] 该目录结构只是默认生成的(单应用模式),具体会因为你是否采用多应用模式而存在差异。
## 入口文件
由于`5.2`版本完全依赖`Composer`,取消了原本的`think\Loader`类,因此入口文件的写法有所调整。
系统安装后提供了一个默认的入口文件(位于`public/index.php`),内容如下:
```
// [ 应用入口文件 ]
namespace think;
require __DIR__ . '/../vendor/autoload.php';
// 执行应用并响应
(new App())->run()->send();
```
如果`app`目录下面直接是`controller`、`model`以及`view`等类库目录,则为单应用模式(默认模式),如果在`app`目录下创建了应用子目录,则自动变成多应用模式。
单应用和多应用的目录结构区别如下(主要在`app`目录):
单应用
```
├─app 应用目录
│ ├─controller 控制器目录
│ ├─model 模型目录
│ ├─view 视图目录
│ └─ ... 更多类库目录
├─public WEB目录(对外访问目录)
│ ├─index.php 入口文件
├─config 应用配置目录
├─route 路由定义目录
├─runtime 应用的运行时目录
```
多应用
```
├─app 应用目录
│ ├─index 主应用
│ │ ├─controller 控制器目录
│ │ ├─model 模型目录
│ │ ├─view 视图目录
│ │ ├─config 配置目录(优先)
│ │ └─ ... 更多类库目录
│ ├─app2 应用2
│ │ ├─controller 控制器目录
│ │ ├─model 模型目录
│ │ ├─view 视图目录
│ │ ├─config 配置目录(优先)
│ │ └─ ... 更多类库目录
├─public WEB目录(对外访问目录)
│ ├─index.php 主入口文件
│ ├─app2.php 入口文件2
├─config 应用配置目录
│ ├─index index应用配置
│ └─app2 app2应用配置
├─route 路由定义目录
│ ├─index index应用路由定义目录
│ └─app2 app2应用路由定义目录
├─runtime 应用的运行时目录
│ ├─index index应用运行时目录
│ └─app2 app2应用运行时目录
```
从目录结构可以看出来,每个应用相对保持独立,并且每个应用都有一个对应的入口文件,应用下面还可以通过多级控制器来维护控制器分组。
通过URL重写可以实现在一个统一的入口文件访问不同的应用。
新版的`think\App`类的定制性更灵活,你可以在入口文件中对应用进行定制。
```
// [ 应用入口文件 ]
namespace think;
require __DIR__ . '/../vendor/autoload.php';
// 实例化应用
$app = new App();
// 设置当前应用的路径
$app->path('path/to/name');
// 开发调试模式
$app->debug(true);
// 设置应用名称
$app->name('name');
// 设置应用的命名空间
$app->setNamespace('app\name');
// 开启应用类库后缀
$app->suffix(true);
// 绑定当前应用的请求对象
$app->bind('request', $request);
// 执行应用并输出响应
$app->run()->send();
```
如果你的某个应用来自于`composer`库,只需要在入口文件中指定应用的命名空间。
## 命令行
如果采用了多应用模式,命令行可以支持生成不同应用的类文件
```
php think make:controller index@User
php think make:model app2@Blog
```
## Db类和模型
`Db`类也采用了`Facade`机制,所以你在使用`Db`类查询的时候,应该使用:
```
use think\facade\Db;
...
Db::name('user')->find();
```
模型的用法目前基本上变化不大。
## 事件机制
事件机制用于替代5.1版本的`Hook`和行为,可以通过命令行生成事件类。
```
php think make:event index@User
```
```
namespace app\index\event;
class UserLogin
{
}
```
生成监听器
```
php think make:listener index@UserLogin
```
```
namespace app\index\listener;
class UserLogin
{
public function handle($event)
{
// 事件监听处理
}
}
```
给事件绑定别名
```
Event::bind('UserLogin', '\app\index\event\UserLogin');
```
使用监听器
```
Event::listen('UserLogin', '\app\index\listener\UserLogin');
```
或者手动注册事件监听
```
use think\facade\Event;
Event::listen('UserLogin', function(){
});
```
生成事件订阅类
```
php think make:subscribe index@User
```
```
namespace app\index\subscribe;
class User
{
public function onUserLogin($event)
{
// 事件响应处理
}
}
```
注册事件订阅者
```
Event::subscribe('\app\index\subscribe\User');
```
上面的相关操作可以通过在应用目录的`event.php`文件中直接配置,而无需手动操作。
```
return [
'bind' => [
'UserLogin' => ['\app\index\event\UserLogin'],
// 更多事件别名定义
],
'listen' => [
'UserLogin' => ['\app\index\listener\UserLogin'],
// 更多事件监听
],
'subscribe' => [
'\app\index\subscribe\User',
// 更多事件订阅
],
];
```
内置已经绑定别名的事件包括`AppInit`、`AppBegin`、`ActionBegin`、`AppEnd`等,也就是说原来的`Hook`钩子已经全部改造为事件类。
## 废弃用法
* 模块概念(应用下不再有模块的概念,用多级控制器替代);
* Hook和行为系统(使用事件系统替代);
* 路由的数组返回定义(统一使用方法定义路由);
* Session的前缀机制(已经被简化);
* Config的`range`机制(已经被简化);
* 核心`Facade`类的别名(避免混淆而废弃);
- 值得升级到5.1的18个理由
- 5.1.7版本新特性
- JSON字段类型在ORM中的使用
- 文件下载响应对象
- 教你使用5.1的数组对象查询
- 模型三大利器之一:搜索器
- 在ThinkPHP中使用Yaconf
- 掌握命令行的表格输出
- 5.1.25查询参数绑定的改进
- ThinkPHP安全规范指引
- 巧用数据集的排序功能实现统计排序
- think-orm ——基于5.1的独立ORM库
- think-template——基于ThinkPHP的独立模板引擎
- ThinkPHP5.1.26版本发布——修正版本,包含安全更新
- ThinkPHP5.0和3.2再发安全更新
- 官宣:ThinkPHP发布首个LTS版本
- 你真的了解Db类和模型的正确使用姿势么?
- 如何更有效的记录和管理日志
- 模型三大利器之二:修改器
- ThinkPHP5.1.28版本发布——修正上一版本问题,改进关联查询
- 模型三大利器之三:获取器
- API版本控制的几种思路
- ThinkPHP5.2第一个Beta版本发布测试
- 让你少犯错的数据查询基本原则
- ThinkPHP发布5.1.29版本——常规更新
- 这15个好习惯让你更容易升级到5.2
- 如何有效提高ThinkPHP的应用性能
- 让你提高开发效率的查询技巧
- 模型关联查询不完全指南
- 5.2发布Beta2版本——统一和精简大量用法
- ThinkPHP发布5.1.30版本——支持微秒时间字段写入
- ThinkPHP的数据缓存使用
- ThinkPHP5.2安装及入口文件
- ThinkPHP荣获2018 年度最受欢迎中国开源开发框架第1名
- 5.1路由使用心得技巧
- ThinkPHP5.*版本发布安全更新
- ThinkPHP项目及代码规范指北
- 5.2版本的设计规范指导
- ThinkPHP5.1.32版本发布——圣诞快乐
- 利用Trait特性给模型增加乐观锁功能
- 5.2数据库和模型的变化(摘要)
- ThinkPHP模板引擎实现和常见问题
- ThinkPHP5.0.24版本发布——安全更新
- 不忘初心,方得始终——ThinkPHP十三周年报告
- ThinkPHP5+相关资源汇总
- 异步社区ThinkPHP周年庆专享优惠活动
- 5.2路由的调整和改进
- ThinkPHP发布5.1.33版本——包含安全更新
- ThinkPHP扩展开发指南
- ThinkPHP发布5.2Beta3版本
- ThinkPHP发布5.1.34版本——喜迎新年
- ThinkPHP发布5.2RC1版本
- ThinkPHP发布5.1.35版本——常规更新
- 5.2配置类的调整
- 5.2时间查询的改进和优化
- 5.2RC版本升级不完全指导(仅供学习参考)
- ThinkPHP5.2版本正式变更为6.0版本
- ThinkPHP百度云云虚拟主机专享免费活动
- 事件系统以及查询事件、模型事件的使用
- ThinkPHP6.0RC2版本发布——架构升级、精简核心
- ThinkPHP5.1.36LTS版本发布——常规更新
- 新版Session和Cookie设计变化
- ThinkPHP5.1.37版本发布——常规更新
- ThinkPHP6.0RC3版本发布——细节完善,体验优化
- 6.0中间件使用详解
- Composer各大厂商镜像地址
- ThinkPHP6.0发布计划公告
- 「ThinkPHP开发者周刊」招募志愿者
- ThinkPHP6.0日志变化
- ThinkPHP5.1.38版本发布——常规更新
- ThinkPHP6.0RC4版本发布——ORM独立,日志多通道支持
- ThinkORM2.0开发指南上线
- ThinkPHP6.0RC5版本发布——多应用模式独立,中间件机制调整
- ThinkPHP6.0版本发布——程序员节福利
- ThinkPHP5.1.39LTS版本发布——常规更新
- ThinkPHP6.0.1版本发布——圣诞快乐!
- 回顾2019,展望2020!
- ThinkPHPV6.0.2版本发布——2020新春快乐!
- 周年福利系列:Swoole合作优惠
- 亿速云成为ThinkPHPV6.0独家赞助发布商🎉
- 新冠疫情工具和限免资源专题(保持更新中)
- 周年福利系列:创宇信用认证合作优惠
- 周年福利系列:码云企业版限时10%优惠
- 周年福利系列:想天短说抵现优惠
- think-swoole直播:从零开始掌握swoole开发
- 周年福利系列:B2C开源电商ShopXO授权8折优惠
- 周年福利系列:LayuiAdmin 永久授权限时优惠
- ThinkPHP资源导航站上线——构建生态 服务未来
- ThinkPHP官方技术支持服务和应用服务市场上线公测
- ThinkPHP市场精选——推广基本要素
- ThinkPHP市场精选——客服聊天专题
- ThinkPHPV6.0.3版本发布——端午安康
- ThinkPHP开发者扶持计划
- 6.0.3版本关键更新及升级事项
- 「ThinkPHP开发者周刊」改版重启
- ThinkPHP市场精选——企业建站专题
- ThinkPHP 提供统一API接口服务
- ThinkPHP市场精选——直播电商专题
- ThinkAPI服务SDK发布
- 官方服务市场启用独立子域名
- ThinkPHP市场精选——刷脸支付专题
- ThinkAPI推出会员服务计划
- ThinkPHPV6.0.4版本发布——中秋国庆双节快乐
- ThinkPHPV5.1.40版本发布——常规更新
- 1024程序员节福利走一波
- ThinkPHP V6.0.5版本发布——兼容Composer2.0
- 知识图谱应用场景——源论技术沙龙
- ThinkPHP5.*版本改进Composer2.0的兼容
- 官方市场双十一精选推荐
- 技术人做产品有机会么(文末送课程)
- 本周秒杀——古德云售后获客营销系统
- ThinkAPI服务更新——支持接口分组和PHP版本依赖调整
- PHP8新特性盘点
- PHP8新特性系列:构造器属性提升使用及注意事项
- ThinkPHP2021新年寄语
- ThinkPHP V6.0.6&V5.1.41版本发布——兼容PHP8.0
- PHP如何更优雅地调用API接口
- ThinkPHP V6.0.7发布——修正版本
- ThinkAPI服务更新——IP白名单
- 最新版ThinkORM对于时间字段的调整
- ThinkAPI短信接口正式上线
- ThinkPHP V6.0.8版本发布——多环境变量配置支持
- 顶想云写作服务开启第一次公测
- ThinkSSL上线——官方SSL/TLS证书服务
- MDBootstrap国内用户福利——ThinkPHP官方市场首发
- ThinkPHP V6.0.9版本发布——常规更新
- ThinkORM功能盘点——虚拟模型
- 全面支持主流GIT版本库——云写作服务第二次公测
- 云写作服务私有化部署方案之:版本库私有化
- 看云双十一活动
- ThinkPHP V6.0.10LTS发布——兼容PHP8.1
- ThinkPHP V6.0.12发布——命令行兼容8.1
- 顶想云知识管理上线公测——构建企业文档中心和知识库
- 顶想云上线——助力生态数字化建设
- 618活动进行中——官方市场迎来一波更新
- 顶想云知识管理正式上线——看云文档启动迁移服务
- ThinkPHP V6.0.13发布——常规更新
- 顶想云网站助理服务上线——构建产品支持服务
- ThinkPHP发布6.1.0&6.0.14版本——安全更新
- ThinkPHP新版社区上线试运营
- ThinkAPI上架人脸核身接口——助力网站实名认证
- 辞旧迎新——旧版社区停止注册及发帖
- ThinkPHP6.1.2版本发布——兼容PHP8.2