|
|
@@ -1,8 +1,111 @@
|
|
|
workerman
|
|
|
=========
|
|
|
|
|
|
-High performance RPC server framework for network applications implemented in PHP using libevent
|
|
|
+workerman 是一个高性能的PHP Rpc服务框架，开发者可以在这个框架下开发各种网络应用。
|
|
|
+workerman 具有以下特性
|
|
|
+ * 多进程
|
|
|
+ * 支持TCP/UDP
|
|
|
+ * 支持各种应用层协议
|
|
|
+ * 使用libevent事件轮询库，支持高并发
|
|
|
+ * 支持文件更新检测及自动加载
|
|
|
+ * 支持服务平滑重启
|
|
|
+ * 支持telnet远程控制及监控
|
|
|
+ * 支持异常监控及告警
|
|
|
+ * 支持长连接
|
|
|
+ * 支持以指定用户运行worker进程
|
|
|
|
|
|
-start
|
|
|
+所需环境
|
|
|
+========
|
|
|
+
|
|
|
+workerman需要PHP版本不低于5.3，只需要安装PHP的Cli即可，无需安装PHP-FPM、nginx、apache
|
|
|
+workerman不能运行在Window平台
|
|
|
+
|
|
|
+安装
|
|
|
=========
|
|
|
-./bin/workermand start
|
|
|
+
|
|
|
+以ubuntu为例
|
|
|
+安装PHP Cli
|
|
|
+`sudo apt-get install php5-cli`
|
|
|
+强烈建议安装libevent扩展，以便支持更高的并发量
|
|
|
+`sudo pecl install libevent`
|
|
|
+建议安装proctitle扩展(php5.5及以上版本原生支持，无需安装)，以便方便查看进程信息
|
|
|
+`sudo pecl install proctitle`
|
|
|
+
|
|
|
+
|
|
|
+启动停止
|
|
|
+=========
|
|
|
+
|
|
|
+以ubuntu为例
|
|
|
+
|
|
|
+启动
|
|
|
+sudo ./bin/workermand start
|
|
|
+
|
|
|
+重启启动
|
|
|
+sudo ./bin/workermand restart
|
|
|
+
|
|
|
+平滑重启/重新加载配置
|
|
|
+sudo ./bin/workermand reload
|
|
|
+
|
|
|
+查看服务状态
|
|
|
+sudo ./bin/workermand status
|
|
|
+
|
|
|
+停止
|
|
|
+sudo ./bin/workermand stop
|
|
|
+
|
|
|
+Rpc应用客户端使用方法
|
|
|
+=========
|
|
|
+
|
|
|
+同步调用：
|
|
|
+
|
|
|
+```php
|
|
|
+<?php
|
|
|
+include_once 'yourdir/RpcClient.php';
|
|
|
+
|
|
|
+$address_array = array(
|
|
|
+ 'tcp://127.0.0.1:2015',
|
|
|
+ 'tcp://127.0.0.1:2015'
|
|
|
+ );
|
|
|
+// 配置服务端列表
|
|
|
+RpcClient::config($address_array);
|
|
|
+
|
|
|
+$uid = 567;
|
|
|
+
|
|
|
+// User对应applications/Rpc/Services/User.php 中的User类
|
|
|
+$user_client = RpcClient::instance('User');
|
|
|
+
|
|
|
+// getInfoByUid对应User类中的getInfoByUid方法
|
|
|
+$ret_sync = $user_client->getInfoByUid($uid);
|
|
|
+
|
|
|
+```
|
|
|
+
|
|
|
+异步调用：
|
|
|
+RpcClient支持异步远程调用
|
|
|
+
|
|
|
+```php
|
|
|
+<?php
|
|
|
+ // 服务端列表
|
|
|
+ $address_array = array(
|
|
|
+ 'tcp://127.0.0.1:2015',
|
|
|
+ 'tcp://127.0.0.1:2015'
|
|
|
+ );
|
|
|
+ // 配置服务端列表
|
|
|
+ RpcClient::config($address_array);
|
|
|
+
|
|
|
+ $uid = 567;
|
|
|
+ $user_client = RpcClient::instance('User');
|
|
|
+
|
|
|
+ // 异步调用User::getInfoByUid方法
|
|
|
+ $user_client->asend_getInfoByUid($uid);
|
|
|
+ // 异步调用User::getEmail方法
|
|
|
+ $user_client->asend_getEmail($uid);
|
|
|
+
|
|
|
+ 这里是其它的业务代码
|
|
|
+ ....................
|
|
|
+ ....................
|
|
|
+
|
|
|
+ // 需要数据的时候异步接收数据
|
|
|
+ $ret_async1 = $user_client->arecv_getEmail($uid);
|
|
|
+ $ret_async2 = $user_client->arecv_getInfoByUid($uid);
|
|
|
+
|
|
|
+ 这里是其他业务逻辑
|
|
|
+
|
walkor