2018-11-28 13:26:18 +08:00
2018-11-28 13:26:18 +08:00
2018-10-29 11:47:58 +08:00
2018-11-28 13:26:18 +08:00
2018-11-28 13:26:18 +08:00
2018-04-23 15:04:10 +08:00
2018-04-28 17:05:37 +08:00
2018-11-28 13:26:18 +08:00
2018-11-28 13:26:18 +08:00

CQBot-swoole

A fast and multi-task framework for Coolq-HTTP-API
一个快速、多进程的CQ-HTTP-API插件框架 made by php-swoole

作者QQ

什么是swoole

Swoole是一个C编写的、高性能的PHP扩展。支持多线程、多进程、同步、异步、协程、SQL等。
Swoole的用处最简单可以理解为只需要简单几行代码即可运行一个HTTP服务器比python等同类型解释型语言快非常多。
此外小声说Swoole官方声明Swoole将重新定义PHP
官网点我



框架简介

· CQBot-swoole采用swoole框架为基础在框架上以PHP作为开发语言进行编写。
· CQBot采用常驻内存+websocket的方式最大程度地提升了CQHTTP插件处理消息事件的速度
· 框架采用快速开发的模板,可以在非常短的时间内添加一个功能
· 框架保留了微信公众号接口,后期我会添加和微信公众号的互通
· 框架本身比较大,更适用于处理消息量特别大、功能比较复杂的机器人
· 框架自带HTTP服务器可以同时使用HTTP服务器完成相关业务逻辑
· 框架包含一些基础的功能,当然目前还正在不断添加中
· 支持外置扩展加载邮件收发、Excel、Word文件处理等



环境需求

1. Linux由于酷Q是基于Windows版的所以这里推荐搭配docker版
2. php7.0以上
3. php-mbstring多字节扩展
4. swoole-2.x
5. screen可选
6. CQ-http-api插件和酷Qdocker版


环境部署

安装docker-coolq

如果你想重新开始则运行安装richardchien的docker镜像快速安装即可
$ docker pull richardchien/cqhttp:latest
$ git clone https://github.com/BlueWhaleNetwork/CQBot-swoole.git
$ mkdir coolq  # 用于存储酷 Q 的程序文件

#如果你想将docker运行在screen里输入下面的指令 $ screen -R coolq

#将启动脚本移到和coolq目录平级的文件夹可选 $ mv CQBot-swoole/run.sh ./

#启动docker的指令 $ sh ./run.sh

docker启动后打开浏览器输入http://你的服务器地址:9000
默认密码为MAX8char此后登陆QQ即可



Framework部署

由于Framework是基于swoole和php7的所以需要先安装php7和swoole扩展
由于本教程不是PHP安装教程所以仅简单介绍PHP安装具体安装步骤可以自己google一下

1. Debian系安装PHP

#安装PHP
$ sudo apt-get install php php-dev php-mbstring php7

#测试php安装是否成功 $ php -v

2. 安装swoole扩展

#从github拉取
$ git clone https://github.com/swoole/swoole-src.git
$ cd swoole-src
$ phpize
$ ./configure
$ make && make install

3. 编辑php.ini文件添加swoole

#找到php.ini文件
#一般在/etc/php.ini或者/etc/php/7.0/cli/php.ini或其他地方
$ php -i # 可以查看php.ini位置

#修改php.ini添加swoole.so到扩展列表里

#if使用vim编辑 $ sudo vim /etc/php.ini

#找到extension=xxxx.dll一堆那个地方 #插入一行extension=swoole.so #然后就成功安装了swoole扩展

4. 运行框架

#框架可运行在screen方便驻留后端并查看log
$ screen -R fw

#运行框架 $ cd CQBot-swoole/ $ php start.php

5. 修改自己的参数

你可以进入start.php文件中修改自己的机器人管理群、管理员QQ号、错误日志显示等级等功能。

当然由于swoole和php的安装步骤较为复杂我会抓紧制作CQBot-swoole的docker镜像此后可以直接使用docker启动框架
这个框架作者在使用,从炸毛机器人的框架中移植。

获得过:
计算机应用能力大赛二等奖
溢达全国创意大赛一等奖
未来可能会拿到全国计算机设计大赛的奖

如有任何问题可以随时戳死作者哦
Description
协程、高性能、灵活的聊天机器人 & Web 开发框架(炸毛框架)
Readme Apache-2.0 62 MiB
Languages
PHP 94.9%
Shell 4.7%
Batchfile 0.2%
Dockerfile 0.1%