Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/fucongcong/GroupCo

PHP的服务化框架。适用于Api、Http Server、Rpc Server；帮助原生PHP项目转向微服务化。出色的性能与支持高并发的协程相结合
https://github.com/fucongcong/GroupCo

async bff coroutines generator mysql pool redis soa swoole

Last synced: about 2 months ago
JSON representation

PHP的服务化框架。适用于Api、Http Server、Rpc Server；帮助原生PHP项目转向微服务化。出色的性能与支持高并发的协程相结合

Host: GitHub
URL: https://github.com/fucongcong/GroupCo
Owner: fucongcong
Created: 2017-06-30T03:48:46.000Z (about 7 years ago)
Default Branch: master
Last Pushed: 2020-07-28T02:20:22.000Z (about 4 years ago)
Last Synced: 2024-05-22T19:30:21.344Z (4 months ago)
Topics: async, bff, coroutines, generator, mysql, pool, redis, soa, swoole
Language: PHP
Homepage:
Size: 951 KB
Stars: 479
Watchers: 37
Forks: 68
Open Issues: 2
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

awesome-swoole - GroupCo - A web framework for API, Http server, RPC server, micro service and high concurrency use cases. (Framework)

README

        # Group-Co

[![Build Status](https://travis-ci.org/fucongcong/co-framework.svg?branch=master)](https://travis-ci.org/fucongcong/Group-Co) 

[![Code Climate](https://codeclimate.com/github/fucongcong/co-framework/badges/gpa.svg)](https://github.com/fucongcong/Group-Co)

### V2.0的几个重要改动 

- 不在支持php5.6以下版本。php>=7.0

- 基础服务之间的依赖与通信松耦合(写业务时要考虑到事务的处理)

- 数据传输通过protobuf编码，所以基础服务层编码规范要严格定义数据类型

- 将基础服务拆分了，单独分离了接口(API interface)与ServiceImpl。

### [V1.X版本](https://github.com/fucongcong/GroupCo/tree/v1.1.1)

### 框架结构

框架其实分为两大板块, 协程客户端(BFF —— Backend For Frontend)与提供基础服务的服务端。

#### 客户端（BFF）

* 利用协程特性以同步方式来编写异步代码，增强可读性。

* 将swoole的异步特性与传统框架的MVC相结合。

* 和nodejs类似，BFF端应该是胶水层(类似传统MVC的控制层)，API提供者

#### 服务端 

* 利用swoole的多进程模式创建，当前版本仅支持RPC调用。

#### 服务化

* 目前实现了以Zookeeper、Redis、Mysql为注册中心的服务化治理.

* 支持了Apollo的配置中心化

* 服务发现，客户端缓存、心跳检测、服务监听

### 如何使用协程客户端，与传统框架的区别？

* 框架基本使用与传统框架基本一致，路由，控制器，调用基础服务

* 在异步调用的地方需要以yield关键词来触发协程切换

### 为什么服务端不采用swoole的4.X版本协程？

* 业务码迁移方便。不使用协程，在原项目或者新项目微服务化时，可以无脑迁移，完全不用担心协程化导致的连接释放、全局变量问题等等诸多限制。

* 多进程模式可以将单连接请求速度优化，利用task机制

* 稳定性、已得到线上验证

### 生产环境使用

* GroupCo框架目前已经全线用于我们团队，日均处理请求百万次。响应时间平均在0.1ms-10ms左右(视业务而定)

* 大型项目，服务发现不建议使用redis/mysql。也可以自己集成etcd/consul等其他服务发现工具（框架后面会更新支持）

### 特性

* 全异步协程调度，支持高并发

* 服务发现，客户端缓存、心跳检测、服务监听

* 统一配置中心

* 异步TCP，HTTP客户端

* 异步日志

* 异步文件读写

* 异步Mysql

* 异步Mysql事务处理

* 异步Redis

* 支持Tcp、Mysql、Redis、WebSocket连接池

* SOA服务化调用，内部封装完整的RPC通信，服务端采用异步Task处理后合并数据并返回。

* 异步TCP客户端支持并行、串行调用

* Twig、Doctrine支持视图、服务数据层

* 单元测试覆盖

### 文档总览

* 快速开始

  * [环境依赖](doc/yin-yan/huan-jing-yi-lai.md)

  * [启动项目](doc/yin-yan/qi-dong-xiang-mu.md)

  * [Docker容器启动](doc/yin-yan/docker.md)

* 客户端

  * [异步Tcp客户端](doc/kuang-jia-fu-wu/yi-bu-tcp-ke-hu-duan.md)

  * [异步WebSocket客户端](doc/kuang-jia-fu-wu/yi-bu-websocket-ke-hu-duan.md)

  * [异步Http客户端](doc/kuang-jia-fu-wu/yi-bu-http-ke-hu-duan.md)

  * [异步Redis客户端](doc/kuang-jia-fu-wu/sd.md)

  * [异步Mysql客户端](doc/kuang-jia-fu-wu/yi-bu-mysql-ke-hu-duan.md)

  * [异步Log日志](doc/kuang-jia-fu-wu/yi-bu-log.md)

  * [异步文件读写](doc/kuang-jia-fu-wu/yi-bu-wen-jian-du-xie.md)

  * [异常Exception](doc/kuang-jia-fu-wu/yi-chang-exception.md)

* 服务端\(用于基础服务开发\)

  * [Service](doc/tong-bu-fu-wu/service.md)

  * [Dao](doc/tong-bu-fu-wu/dao.md)

  * [Cache](doc/tong-bu-fu-wu/rediscache.md)

  * [Log日志类](doc/tong-bu-fu-wu/logri-zhi-lei.md)

  * [FileCache文件缓存类](doc/tong-bu-fu-wu/filecachewen-jian-huan-cun-lei.md)

* 服务中心

  * [服务治理流程](doc/fu-wu-zhong-xin/fu-wu-zhi-li-liu-cheng.md)

  * [注册中心](doc/fu-wu-zhong-xin/zhu-ce-zhong-xin.md)

  * [服务调用](doc/fu-wu-zhong-xin/yi-bu-http-server-zhong-shi-yong-fu-wu.md)

  * [使用TCP连接池](doc/fu-wu-zhong-xin/yi-bu-http-server-lian-jie-chi.md)

  * [服务调用监控](doc/fu-wu-zhong-xin/fu-wu-diao-yong-jian-kong.md)

  * [服务调用失败事件](doc/fu-wu-zhong-xin/fu-wu-diao-yong-shi-bai.md)

  * [调试模式](doc/fu-wu-zhong-xin/diao-shi-mo-shi.md)

* 配置中心

  * [配置中心的使用](doc/pei-zhi-zhong-xin/shi-yong.md)

* 框架基础类

  * [Config配置类](doc/ji-chu-fu-wu/config.md)

  * [StaticCache静态缓存类](doc/ji-chu-fu-wu/staticcache.md)

  * [Route路由类](doc/ji-chu-fu-wu/routelu-you-lei.md)

  * [Controller控制器类](doc/ji-chu-fu-wu/controllerkong-zhi-qi-lei.md)

  * [View视图类](doc/ji-chu-fu-wu/viewshi-tu-lei.md)

  * [Request请求类](doc/ji-chu-fu-wu/requestqing-qiu-lei.md)

  * [Response响应类](doc/ji-chu-fu-wu/responsexiang-ying-lei.md)

  * [Event事件类](doc/ji-chu-fu-wu/eventshi-jian-lei.md)

  * [Listener监听类](doc/ji-chu-fu-wu/listenerjian-ting-lei.md)

  * [Subscriber多事件监听](doc/ji-chu-fu-wu/subscriberduo-shi-jian-jian-ting.md)

  * [EventDispatcher事件调度](doc/ji-chu-fu-wu/eventdispatchershi-jian-diao-du-lei.md)

* [单元测试](doc/dan-yuan-ce-shi/dan-yuan-ce-shi.md)

* [控制台](doc/kong-zhi-tai/kong-zhi-tai.md)

### 案例Demo与最佳实践

- [WebSocket简单示例,聊聊集群时的消息转发](doc/demo/ws.md)

- [实现服务异常邮件通知](doc/demo/fu-wu-yi-chang.md)

- [秒杀系统,与GO切磋](https://github.com/fucongcong/GroupCo/tree/co/seckill)

- [日志分析服务](doc/demo/log.md)

- Api服务

### BUG反馈

如果你在使用过程中遇到安全或者框架层面使用bug，请提issue。

### 架构模型

- [架构模型](doc/fu-wu-zhong-xin/jiagou.md)

### 与Go的协程的区别

基于Swoole的异步与php的Generator实现的异步协程，而go语言是内置协程。