## Workerman
> Workerman是一款纯PHP开发的开源高性能的PHP socket 服务器框架。被广泛的用于手机app、手游服务端、网络游戏服务器、聊天室服务器、硬件通讯服务器、智能家居、车联网、物联网等领域的开发。 支持TCP长连接,支持Websocket、HTTP等协议,支持自定义协议。基于workerman开发者可以更专注于业务逻辑开发,不必再为PHP Socket底层开发而烦恼。
## 安装
首先通过 composer 安装
~~~
composer require topthink/think-worker
~~~
## 使用
### 使用`Workerman`作为`HttpServer`
在命令行启动服务端
~~~
php think worker
~~~
然后就可以通过浏览器直接访问当前应用
~~~
http://localhost:2346
~~~
linux下面可以支持下面指令
~~~
php think worker [start|stop|reload|restart|status]
~~~
`workerman`的参数可以在应用配置目录下的`worker.php`里面配置。
> 由于`onWorkerStart`运行的时候没有`HTTP_HOST`,因此最好在应用配置文件中设置`app_host`
### SocketServer
在命令行启动服务端(需要`2.0.5+`版本)
~~~
php think worker:server
~~~
默认会在0.0.0.0:2345开启一个`websocket`服务。
如果需要自定义参数,可以在`config/worker_server.php`中进行配置,包括:
| 配置参数 | 描述 |
| --- | --- |
| protocol | 协议 |
| host | 监听地址 |
| port | 监听端口 |
| socket | 完整的socket地址 |
并且支持`workerman`所有的参数(包括全局静态参数)。
也支持使用闭包方式定义相关事件回调。
~~~
return [
'socket' => 'http://127.0.0.1:8000',
'name' => 'thinkphp',
'count' => 4,
'onMessage' => function($connection, $data) {
$connection->send(json_encode($data));
},
];
~~~
也支持使用自定义类作为`Worker`服务入口文件类。例如,我们可以创建一个服务类(必须要继承 `think\worker\Server`),然后设置属性和添加回调方法
~~~
<?php
namespace app\http;
use think\worker\Server;
class Worker extends Server
{
protected $socket = 'http://0.0.0.0:2346';
public function onMessage($connection,$data)
{
$connection->send(json_encode($data));
}
}
~~~
支持`workerman`所有的回调方法定义(回调方法必须是public类型)
然后在`worker_server.php`中增加配置参数:
~~~
return [
'worker_class' => 'app\http\Worker',
];
~~~
定义该参数后,其它配置参数均不再有效。
在命令行启动服务端
~~~
php think worker:server
~~~
然后在浏览器里面访问
~~~
http://localhost:2346
~~~
如果在Linux下面,同样支持reload|restart|stop|status 操作
~~~
php think worker:server reload
~~~
> 注意:使用默认worker做服务器时,`dump`会打印到命令行.
### 关于上传文件
当按照默认的worker做http服务器时,并不能直接使用`request()->file('image')`来获得上传的文件,具体可以参考[workerman的上传文件第6点](http://doc.workerman.net/web-server.html).因此只能迂回的使用`Filesystem`.无论怎样,不影响其`getMime()`等方法的正确性.
```
// $file = request()->file('image');
$file_data = $_FILES[0]['file_data'];
//$tmp_file = tempnam('','tm_'); 这种写法最终保存时扩展名为.tmp
$tmp_file = sys_get_temp_dir().'/'.uniqid().'.'.explode('/',$_FILES[0]['file_type'])[1];
file_put_contents($tmp_file,$file);
$file = new File($tmp_file);
$savename = Filesystem::putFile('upload',$file);
echo $savename;
```
- 序言
- 基础
- 安装
- 开发规范
- 目录结构
- 配置
- 架构
- 请求流程
- 架构总览
- 入口文件
- 多应用模式
- URL访问
- 容器和依赖注入
- 服务
- 门面
- 中间件
- 事件
- 路由
- 路由定义
- 变量规则
- 路由地址
- 路由参数
- 路由中间件
- 路由分组
- 资源路由
- 注解路由
- 路由绑定
- 域名路由
- MISS路由
- 跨域请求
- URL生成
- 控制器
- 控制器定义
- 基础控制器
- 空控制器
- 资源控制器
- 控制器中间件
- 请求
- 请求对象
- 请求信息
- 输入变量
- 请求类型
- HTTP头信息
- 伪静态
- 参数绑定
- 请求缓存
- 响应
- 响应输出
- 响应参数
- 重定向
- 文件下载
- 数据库
- 连接数据库
- 分布式数据库
- 查询构造器
- 查询数据
- 添加数据
- 更新数据
- 删除数据
- 查询表达式
- 链式操作
- where
- table
- alias
- field
- strict
- limit
- page
- order
- group
- having
- join
- union
- distinct
- lock
- cache
- comment
- fetchSql
- force
- partition
- failException
- sequence
- replace
- extra
- duplicate
- procedure
- 聚合查询
- 分页查询
- 时间查询
- 高级查询
- 视图查询
- JSON字段
- 子查询
- 原生查询
- 查询事件
- 获取器
- 事务操作
- 存储过程
- 数据集
- 数据库驱动
- 模型
- 定义
- 模型字段
- 新增
- 更新
- 删除
- 查询
- 查询范围
- JSON字段
- 获取器
- 修改器
- 搜索器
- 数据集
- 自动时间戳
- 只读字段
- 软删除
- 类型转换
- 模型输出
- 模型事件
- 模型关联
- 一对一关联
- 一对多关联
- 远程一对多
- 远程一对一
- 多对多关联
- 多态关联
- 关联预载入
- 关联统计
- 关联输出
- 视图
- 模板变量
- 视图过滤
- 模板渲染
- 模板引擎
- 视图驱动
- 错误和日志
- 异常处理
- 日志处理
- 调试
- 调试模式
- Trace调试
- SQL调试
- 变量调试
- 远程调试
- 验证
- 验证器
- 验证规则
- 错误信息
- 验证场景
- 路由验证
- 内置规则
- 表单令牌
- 注解验证
- 杂项
- 缓存
- Session
- Cookie
- 多语言
- 上传
- 命令行
- 启动内置服务器
- 查看版本
- 自动生成应用目录
- 创建类库文件
- 清除缓存文件
- 生成数据表字段缓存
- 生成路由映射缓存
- 输出路由定义
- 自定义指令
- 扩展库
- 数据库迁移工具
- Workerman
- think助手工具库
- 验证码
- Swoole
- 附录
- 助手函数
- 升级指导
- 更新日志