## 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; ~~~