# Controller控制器
了解MVC架构的开发者对此应该并不陌生,在SD框架中更为简单。
以HTTP请求为例,Http://localhost:8081/AppController/test 以上这个url通过默认路由器的解析会转到名为AppController的控制器并调用旗下test方法。
Controller将暴露一组功能的API方法,他是所有对应功能请求的入口。
Controller在底层的实现比较复杂,他既不是单例模式也不是每次new新对象的模式,而是采用了可复用的对象池模式。
# 对象池模式
在SD框架中对象池模式相当的常见,基本大多数组件都是对象池模式,我们还提供了Pool类帮助开发者创建自己的对象池。
使用对象池会大大减少PHP运行时的new操作,减少内存的分配和GC,对运行效率有明显的提升,内存泄露有明显的改善,但是对象池也不是那么容易使用的。
参与对象池的对象一定是具有以下的功能,首先一定是具有一个初始化的函数比如initialization,它用于代替__construct;其次我们还得拥有个destroy方法用于销毁对象中我们自己定义的对象和值;最后我们通过Pool进行对象池的管理,通过Pool回收一个对象,通过Pool获得一个对象。
所以想更加得心应手的使用SD框架,想了解的更全面,你就得先了解对象池是怎么工作的。
# initialization
initialization是Controller初始化的方法,前面说过了对象池模式会有个初始化方法来代替__construct。
在到达对应方法之前都会先执行initialization。
Http://localhost:8081/AppController/test 为例,SD会先调用AppController->initialization,如果没有抛出异常那么将会执行AppController->test。
# $http_input
在Controller中我们可以通过$http_input获得请求中所有的属性,具体的参考类介绍中的HttpInput
```php
$max = $this->http_input->get('max');
```
# $http_output
在Controller中我们可以通过$http_output来给游览器返回值,具体的参考类介绍中的HttpOutput
这里一定说明下,和fpm框架不同echo,print_r这些都只会在cli屏幕中打印,并不会返回给远端游览器。
```php
$this->http_output->end($result);
```
# defaultMethod
Http://localhost:8081/AppController/test2
如果控制器中没有test2的方法,那么会访问到defaultMethod,开发者可以重写此方法。
# $loader
加载器,可通过加载器加载对应的Model和Task。
```php
$this->testModel = $this->loader->model('TestModel', $this);
$result = $this->testModel->contextTest();
```
# onExceptionHandle
异常的处理,这里很重要!
onExceptionHandle是调用链中集中处理异常的地方,什么是调用链,AController通过loader加载了一个AModel,那么这就是一个调用链。
如果你在Model中抛出了一个异常那么如果不进行捕获,那么最终会在Controller的onExceptionHandle
方法中集中处理。
默认的处理方式会返回给游览器错误信息。比如我在AModel中抛出异常那么如果在AController中没有及时捕获,那么最后会在游览器中看到test字样,并且后续的代码不会执行。
```php
throw new SwooleException('test');
```
我们通过这一特性可以在实现很多方便的功能。
# destroy
销毁
很多情况下你不需要直接调用这个destory方法,在你向客户端返回值的时候,已经自动destory了。
HttpOutPut的end方法是如下描述的,最后一个字段就是destroy,默认是true代表会自动销毁。所以不要在销毁后继续存有未执行完的代码,并不清楚会有什么样的奇怪后果,最好的办法是始终保持destory是代码的最后一行。
```php
function end($output = '', $gzip = true, $destroy = true)
```
如果你想以最快的速度返回给客户端值,然后再处理一些操作,你可以先end('test',true,false),最后手动调用destroy,当然如果是耗时操作尽量调用异步task去执行。
如果你在Controller类中声明了类变量,那么你需要在destroy或者在initialization中手动清除,除非你确认这个变量被携带到另一个请求中没有任何关系。
# 解释
每一个请求在结束之前都拥有一个Controller实例,每一个Controller实例都拥有对应调用链条的Model实例,框架确保在一个请求中这些实例是唯一且不会被其他请求抢占。通过显示调用或者隐示调用了destroy接口,Controller会被立即释放,包括调用的Model也一并会被释放,所以Model是不需要主动destory的,被释放的Controller可能会立即被下一个请求所重用,所以为了避免不可预料的奇怪错误,不要在destroy后还继续存在可执行代码。
# 例子
框架中包含了一部分实例,可以找到TestController.php。
- Introduction
- SD 3.X文档连接
- 导言
- 用户案例
- 基于Swoole扩展分布式全栈开发框架
- 选择SD框架助力企业开发
- 捐赠SwooleDistributed项目
- 框架性能报告
- 更新日志
- VIP服务福利
- 安装与配置
- 【推荐】全自动安装部署
- 环境要求
- 使用Composer安装/更新SD框架
- 通过Docker安装
- 代码结构
- 启动命令
- 服务器配置
- 服务器基础配置server.php
- 客户端协议配置client.php
- business.php
- log.php
- 微服务及集群配置consul.php
- fileHeader.php
- mysql.php
- redis.php
- 定时任务配置timerTask.php
- 服务器端口配置ports.php
- catCache.php
- 验证服务启动成功
- 微服务-Consul
- 日志工具-GrayLog
- 集群-Cluster
- 内核优化
- 入门教学
- 开发流程
- 开发前必读
- 开发规范
- 基本流程
- 框架入口
- Model数据模型
- Controller控制器
- 协程
- 协程基础
- 迭代器
- 调度器
- 使用协程的优势
- 通过协程的方法屏蔽异步同步的区别
- Select多路选择器
- 协程Sleep
- 通用协程方法
- 设置超时
- 设置无异常
- 设置降级函数
- initAsynPools
- dump
- 封装器与路由器
- 封装器
- sendToUid
- 路由器
- sendToUids
- 对象池
- 扩展组件
- 中间件
- Redis使用介绍
- RedisAsynPool
- Redis具体使用
- sendToAll
- RedisRoute
- Redis+Lua
- Mysql使用介绍
- MysqlAsynPool
- Mysql返回值
- 如何获取构建的mysql语句
- 如何执行一个SQL
- 如何执行事务
- stopTask
- Mysql具体使用
- 异步客户端
- Loader
- MqttClient
- model
- SdTcpRpcPool
- task
- HttpClientPool
- view
- TcpClientPool
- AMQP
- initialization
- Memory
- destory
- Cache
- Lock
- Pool
- EventDispatcher
- Process
- Cluster
- TimerTask
- Reload
- Consul
- Context
- 自定义进程
- 进程间RPC
- $http_input
- CatCache
- $http_output
- TimerCallBack
- 专题
- HTTP专栏
- TCP专栏
- 基础知识
- WebSocket专栏
- 微服务
- Consul配置
- RPC
- REST
- AMQP异步任务系统
- MQTT简易服务器
- Docker化以及资源编排
- 快速搭建公司内部统一的开发环境
- 使用HTTPS/WSS
- 订阅/发布
- 游戏专题
- 类介绍
- AppServer
- clearState
- onOpenServiceInitialization
- SwooleDistributedServer
- get_instance
- kickUid
- bindUid
- unBindUid
- coroutineUidIsOnline
- coroutineCountOnline
- setTemplateEngine
- isWebSocket
- isTaskWorker
- getSocketName
- initAsynPools
- addAsynPool
- getAsynPool
- getServerAllTaskMessage
- Controller
- onExceptionHandle
- send
- sendToUid
- sendToUids
- sendToAll
- sendToGroup
- close
- getContext
- defaultMethod
- $redis_pool
- $mysql_pool
- $request_type
- $fd
- $uid
- $client_data
- $request
- $response
- $loader
- $logger
- $server
- $config
- Model
- initialization
- destory
- View
- Task
- stopTask
- HttpInput
- postGet
- post
- get
- getPost
- getAllPostGet
- getAllHeader
- getRawContent
- cookie
- getRequestHeader
- server信息
- getRequestMethod
- getRequestUri
- getPathInfo
- HttpOutput
- setStatusHeader
- setContentType
- setHeader
- end
- setCookie
- endFile
- 单元测试