Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 

README.md

MeepoPS

MeepoPS是Meepo PHP Socket的缩写. 旨在提供高效稳定的由纯PHP开发的多进程SocketService.
MeepoPS可以轻松构建在线实时聊天, 即时游戏, 视频流媒体播放, RPC, 实时监控, 以及原本使用HTTP的接口/定时任务的场景中等.

综述:

  • 目前版本为V0.0.5 ( 查看改动日志 ).
  • PHP作为最好的语言, 不仅仅能依靠Nginx来开发Web应用, 同时,也可以构建高效稳定的即时通讯类Socket应用.
  • MeepoPS的最低运行要求是安装了PHP的PCNTL库.
  • MeepoPS的定位是一个插件. 不但可以独立运行, 也可以依附与ThinkPHP, CodeIgniter, YII等MVC框架中.

传送门:

声明:

  • 绝大多数的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安装
  • 多进程及信号处理需要依赖PHP的PCNTL库. MeepoPS深度依赖PCNTL, 因此PCNTL库是必须安装的, 即使只启动一个进程的MeepoPS, 仍然需要安装PCNTL. 如何安装: PHP手册-PCNTL安装
  • 在大规模访问下, 我们建议安装PHP的PECL扩展Libevent, 但这不是必须的. 在高链接数的场景下, Libevent表现优异. 如何安装: PHP手册-Libevent安装. 截止2016-05-06, PHP官方的Libevent扩展不支持PHP7, PHP7下的Libevent安装方法: PHP7的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/meepo_ps/meepo_ps_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/meepo_ps/meepo_ps_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, 那么客户端是不能外机,只能是本机.
Docker:

我们提供了Docker来快速部署。使用Docker可以快速部署MeepoPS, 我们的容器中已经安装好了MeepoPS、CentOS7、PHP5.6.24、Libevent2.0.20以及他们所需要的各项依赖。

docker pull xyzasd01/meepops-0.0.5-dev

MeepoPS部署在/usr/local/MeepoPS目录下

客户端使用方法:
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接口类文件都是一次实例化.
  6. MeepoPS不但可以实例化多个接口类文件, 也可以实例化同一个接口类文件多次. 比如启动了三个实例, 分别监听了19910, 19911, 19912端口.
  7. 实例化接口类文件并进行了相关设置后, 调用\MeepoPS\runMeepoPS()即可启动MeepoPS.
  8. \MeepoPS\runMeepoPS()之后的所有代码都将不会执行.

示例:

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

测试案例:

请看文档-测试一栏

About

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

Resources

License

Packages

No packages published
You can’t perform that action at this time.