Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lixuancn/MeepoPS

MeepoPS是Meepo PHP Socket的缩写，旨在提供稳定的Socket服务。可以轻松构建在线实时聊天、即时游戏、视频流媒体播放等。
https://github.com/lixuancn/MeepoPS

Last synced: about 1 month ago
JSON representation

MeepoPS是Meepo PHP Socket的缩写，旨在提供稳定的Socket服务。可以轻松构建在线实时聊天、即时游戏、视频流媒体播放等。

Awesome Lists containing this project

README 

        
# MeepoPS

###### MeepoPS是Meepo PHP Socket的缩写. 旨在提供高效稳定的由纯PHP开发的多进程SocketService.

###### MeepoPS可以轻松构建在线实时聊天, 即时游戏, 视频流媒体播放, RPC, 实时监控, 以及原本使用HTTP的接口/定时任务的场景中等.



#### 综述:

- 目前版本为V1.0.0 ( [查看改动日志](http://meepops.lanecn.com/doc/main/1-summary/7-update-log.html) ).

- PHP作为最好的语言, 不仅仅能依靠Nginx来开发Web应用, 同时,也可以构建高效稳定的即时通讯类Socket应用.

- MeepoPS的最低运行要求是安装了PHP的PCNTL库.

- MeepoPS的定位是一个插件. 不但可以独立运行, 也可以依附与ThinkPHP, CodeIgniter, YII等MVC框架中.



#### 传送门:

- 手册地址: http://meepops.lanecn.com

- Github: https://github.com/lixuancn/MeepoPS

- Bug提交: https://github.com/lixuancn/MeepoPS/issues

- 微博: http://weibo.com/lanephp



#### 声明:

- 绝大多数的PHP应用都部署在Linux服务器, 因此MeepoPS不支持非Unix操作系统(例如Windows). 你可以使用Apple Mac(OS X), CentOS, Ubuntu, Red Hat, Fedora, FreeBSD等类Unix操作系统来启动MeepoPS.

- Windows用户可以安装VirtualBox, Vmware等虚拟机软件来运行MeepoPS.

- MeepoPS需要PHP的POSIX库. POSIX是PHP默认安装的, 通常情况下你不需要手动安装. 如何安装: [PHP手册-POSIX安装](http://php.net/manual/zh/posix.installation.php)

- 多进程及信号处理需要依赖PHP的PCNTL库. MeepoPS深度依赖PCNTL, 因此PCNTL库是必须安装的, 即使只启动一个进程的MeepoPS, 仍然需要安装PCNTL. 如何安装: [PHP手册-PCNTL安装](http://php.net/manual/zh/pcntl.installation.php)

- 在大规模访问下, 我们建议安装PHP的PECL扩展Libevent, 但这不是必须的. 在高链接数的场景下, Libevent表现优异. 如何安装: [PHP手册-Libevent安装](http://php.net/manual/zh/libevent.installation.php). 截止2016-05-06, PHP官方的Libevent扩展不支持PHP7, PHP7下的Libevent安装方法: [PHP7的Libevent分支](https://github.com/expressif/pecl-event-libevent)

- 默认监听链接的方式为Select轮询机制. PHP的Select轮询机制最多只能监听1024个链接. 想要突破这个限制, 要么安装Libevent, 要么使用--enable-fd-setsize=2048重新编译安装PHP.



#### 快速入门:



##### 服务端使用方法:

基础功能和用法都写在demo-telnet.php, 基本您就可以直接用. 



###### 普通终端启动:

    1. 启动: 命令行输入"php demo-telnet.php start".

    2. 状态: 命令行输入"php demo-telnet.php status".

    3. 平滑结束: 启动后按下"ctrl + c"即可.

    4. 强行结束: 命令行输入"kill -INT `cat /var/run/meepops/meepops_master.pid`".



###### 守护进程模式启动:

    1. 启动: 命令行输入"php demo-telnet.php start -d".

    2. 状态: 命令行输入"php demo-telnet.php status".

    3. 平滑结束: 命令行输入"php demo-telnet.php stop".

    4. 强行结束: 命令行输入"php demo-telnet.php kill".

    5. 强行结束: 命令行输入"kill -INT `cat /var/run/meepops/meepops_master.pid`".



###### DEMO:

    1. 基于Telnet协议的服务端使用方法请参考demo-telnet.php.

    2. 如果服务端启动的是HOST是0.0.0.0, 那么客户端可以是外机,可以是本机.本机可以是127.0.0.1, 也可以是localhost.

    3. 如果服务端启动的是HOST是127.0.0.1/localhost, 那么客户端是不能外机,只能是本机.



##### 客户端使用方法:



###### Telnet:

    客户端可使用telnet客户端.如: telnet 127.0.0.1 19910



###### 编写代码:

    客户端可借助编程语言的Socket来实现. 可参考Test/test_client.php



##### 惊鸿一瞥:

  1. MeepoPS/config.ini是MeepoPS的配置文件. 采用和php.ini同样的格式, ";"为注释.

  2. 必须引入MeepoPS/index.php文件. 使用MeepoPS都是从 require_once 'MeepoPS/index.php' 开始的.

  3. MeepoPS/Api/目录下的文件为暴露给用户的接口. 需要实例化接口类文件, MeepoPS的使用都是围绕实例化接口文件后的对象来操作的. 实例化的时候传入监听的HOST和端口即可.

  4. MeepoPS会以回调函数的方式来触发您设置的业务逻辑. 比如新链接加入时会回调您设置的"Hello world", 再比如某个链接发送了消息"PING"时, 会回调您设置的返回消息"PONG".

  5. MeepoPS可以启动多个实例, 每一次的new接口类文件都是一次实例化.

  7. MeepoPS不但可以实例化多个接口类文件, 也可以实例化同一个接口类文件多次. 比如启动了三个实例, 分别监听了19910, 19911, 19912端口.

  6. 实例化接口类文件并进行了相关设置后, 调用\MeepoPS\runMeepoPS()即可启动MeepoPS.

  7. \MeepoPS\runMeepoPS()之后的所有代码都将不会执行.



#### 示例:

Example目录下是示例案例, 每一个目录是一个独立的项目. 会不断添加.



#### 测试案例:

[请看文档-测试一栏](http://meepops.lanecn.com/doc/main/8-test/1-event-and-child-proccess.html)