PHP-MSF:基于Swoole的工程级企业微服务框架

服务器
php-msf由Camera360服务器团队主导研发,会持续更新与维护,也希望有更多优秀的 Swoole 应用实践开发者加入。php-msf核心设计思想是采用协程、异步、并行的创新技术手段提高系统的单机吞吐能力,降低整体服务器成本。

Micro Service Framework For PHP

PHP微服务框架即“Micro Service Framework For PHP”,是Camera360社区服务器端团队基于 Swoole 自主研发现代化的PHP协程服务框架,简称msf或者php-msf,是 Swoole 的工程级企业应用框架,经受了Camera360自拍相机亿级用户高并发大流量的考验。php-msf由Camera360服务器团队主导研发,会持续更新与维护,也希望有更多优秀的 Swoole 应用实践开发者加入。php-msf核心设计思想是采用协程、异步、并行的创新技术手段提高系统的单机吞吐能力,降低整体服务器成本。

PHP-MSF:基于Swoole的工程级企业微服务框架

主要特性

  • 精简版的MVC框架
  • IO密集性业务的单机处理能力提升5-10倍
  • 代码长驻内存
  • 支持对象池
  • 支持Redis连接池、MySQL连接池
  • 支持Redis分布式、master-slave部署结构的集群
  • 支持异步、并行
  • 基于PHP Yield实现协程
  • 内建http/redis/mysql/mongodb/task等协程客户端
  • 纯异步的Http Server
  • RPC Server/Client
  • 支持命令行模式
  • 支持独立进程的定时器
  • 支持独立配置进程

环境要求

  • Linux,FreeBSD,MacOS(有兼容问题)
  • Linux内核版本2.3.32以上(支持epoll)
  • PHP-7.0及以上版本(生产环境建议使用PHP-7.1)
  • gcc-4.4以上版本
  • swoole-1.9.15 及以上版本(暂不支持Swoole-2.0)
  • hiredis-0.13.3
  • yac
  • phpredis
  • composer

快速起步

 

  1. $>curl -sS https://cdn.rawgit.com/pinguo/php-msf-docker/214fe1e2/installer.php | php 

installer.php 会检查运行环境,根据你的自定义配置,自动创建项目模板,composer安装依赖,启动服务。

如果一切顺利,运行到最后你将看到如下的输出:

 

  1. [2017-09-06 16:08:34] Run composer install success 
  2. [2017-09-06 16:08:34] Congratulations, all are installed successfully! 
  3. [2017-09-06 16:08:34] You can, visit http://127.0.0.1:8990/Welcome for test 
  4.       _______                               ____ 
  5. ________  / /_  ____        ____ ___  _____/ __/ 
  6. ___/ __ \/ __ \/ __ \______/ __ `__ \/ ___/ /_ 
  7. __/ /_/ / / / / /_/ /_____/ / / / / (__  ) __/ 
  8. _/ .___/_/ /_/ .___/     /_/ /_/ /_/____/_/ 
  9. /_/         /_/         Camera360 Open Source TM 
  10. [2017-09-06 16:08:34] Swoole  Version: 1.9.18 
  11. [2017-09-06 16:08:34] PHP     Version: 7.1.8 
  12. [2017-09-06 16:08:34] Application ENV: docker 
  13. [2017-09-06 16:08:34] Listen     Addr: 0.0.0.0 
  14. [2017-09-06 16:08:34] Listen     Port: 8990 

访问测试:

 

  1. $>curl http://127.0.0.1:8990/Welcome 
  2. hello world! 

注意端口,如果你不是8990,你需要修改,然后访问测试。

标准应用结构

 

  1. ├── app // PHP业务代码 
  2. │   ├── AppServer.php // 应用server类,可根据需求自定义 
  3. │   ├── Controllers // 控制器类目录 
  4. │   ├── Lib // 特殊逻辑处理类目录 
  5. │   ├── Models // Model类目录 
  6. │   ├── Route // 特殊路由规则类目录 
  7. │   ├── Tasks // Task类目录 
  8. │   └── Views // 视图文件目录 
  9. ├── build.sh // 构建脚本(拉取docker镜像,启动容器) 
  10. ├── checkstyle.sh // 代码检查脚本 
  11. ├── composer.json // composer包依赖配置文件 
  12. ├── config // 配置目录 
  13. ├── server.php // server启动脚本 
  14. ├── console.php // 命令行脚本 
  15. ├── test // 单元测试目录 

上述为基于php-msf的标准应用结构,一键安装程序installer.php会自动生成目录,用户可以根据需求创建一些自定义目录,只要符合psr4标准即可自动加载。

服务启动

调试模式

  1. $>./server.php start 

Daemon模式

  1. $>./server.php start -d 

停止服务

  1. $>./server.php stop 

重启服务

 

  1. $>./server.php restart 

Docker

我们制作了Docker镜像,方便Docker用户快速的安装环境,运行 PHP-MSF DEMO 工程。另外期望在开发环境修改代码实时预览效果,建议使用Docker for Mac / Windows 桌面版。

如果是升级Docker,它会自动迁移原有的镜像和容器,请耐心等待,千万不能中途kill掉Docker进程,否则再想迁移就难了。

Docker Registry(阿里云):

  • 公网地址: docker pull registry.cn-hangzhou.aliyuncs.com/pinguo-ops/php-msf-docker:latest
  • 经典内网: docker pull registry-internal.cn-hangzhou.aliyuncs.com/pinguo-ops/php-msf-docker:latest
  • VPC网络: docker pull registry-vpc.cn-hangzhou.aliyuncs.com/pinguo-ops/php-msf-docker:latest
  • DockerHub(国外): docker pull pinguoops/php-msf-docker

框架定位

我们专注打造稳定高性能纯异步基于HTTP的微服务框架,作为nginx+php-fpm的替代技术栈实现架构的微服务化;而Tcp/WebSocket Server将作为插件的形势支持,或者作为其他独立的开源项目。

  • 对于小型团队或者业务系统我们建议还是采用传统的nginx+php-fpm技术栈,对于成本和性能来说没有瓶颈,也就完全没有必要引入全新的技术栈。
  • 对于大中型团队或者业务系统,处在服务治理或者服务化演进的重要阶段,php-msf是可选方案之一。
  • 对于庞大的PHP应用集群,想要大幅节约服务器成本,提升服务性能,php-msf是可选方案之一。
  • 对于聚合服务,比如大型的网站首页,想要通过服务器端聚合内容整合数据,php-msf是可选方案之一。

手工安装

推荐安装方式,通过编辑项目 composer.json 加入依赖 pinguo/php-msf

 

  1.     "require": { 
  2.         "pinguo/php-msf"">=3.0.0" 
  3.     }, 
  4.     "minimum-stability""dev" 

 

"minimum-stability": "dev" 这个配置选项必须加上,因为日志组件依赖 "monolog/monolog": "2.0.x-dev" ,并且 monolog/monolog 无2.0的release包,不过我们在生产环境已经验证其稳定性。

项目原则

稳定

php-msf经受了Camera360社区服务大流量、高并发的洗礼,稳定性得到充分验证。稳定性是我们花了大量时间、精力去解决的最重要问题,是三大原则的最重要原则。

高性能

IO密集性业务的单机处理能力提升5-10倍,这是生产环境中得出的真实数据,如Camera360社区某聚合服务在流量高峰需要40台服务器抗住流量,而采用php-msf重构之后只需要4台相同配置的服务器就可以抗住所有流量。

简单

由于Swoole复杂的进程模型,并且有同步阻塞和异步非阻塞之分,所以在运行相同代码逻辑时,可能在调用方式、传递参数都不一致,从而直线拉高了学习成本,我们为了屏蔽低层的差异,做了大量的工作,实现和传统MVC框架的唯一区别在于添加“yield”关键字。我们参考了Yii2框架的部分代码实践,我们期望无缝的从Yii2开发切换过来。

上述三大原则,是我们在新增特性、功能实现时,投票或者合并代码的依据,任何影响这些原则的PR也将会被拒绝。

关于协程

目前社区有几个PHP开源项目支持协程,它们大多采用Generator+Yield来实现,但是实现的细微差别会导致性能相差甚远,我们应该认识到协程能够以同步的代码书写方式而运行异步逻辑,故协程调度器的性能一定要足够的高,php-msf的协程调度性能是原生异步回调方式的80%,也就是说某个API采用原生异步回调写法QPS为10000,通过php-msf协程调度器调度QPS为8000。

为什么是微服务框架?

目前php-msf还在起步阶段,我们花了大量的时间和精力解决稳定性、高性能、内存问题,因为我们认为“基石”是“万丈高楼”的最基本的保障,只有基础打得牢,才能将“大楼”建设得“更高”。3.0版本是我们开源的起始版本,是我们迈出的重要一步,接下来我们重点会是分布式微服务框架的打磨。

另外,由于基于PHP长驻进程,并直接解析HTTP或者TCP请求,这是服务化最重要的支撑,基于此我们可以做很多原来不敢去实现的想法,总之想像空间很大。

感谢

php-msf最开始基于 SwooleDistributed-1.7.x 开发,而此次开源版本中,连接池主要采用了SD的实现。由于我们框架定位、解决的业务场景、稳定性的要求、代码风格等差异太大,因此我们决定自主研发微服务框架,每个框架都有自己的特色和优点,选择合适自己公司和业务场景的框架最重要,同时在此也感谢 白猫 ;另外,在研发php-msf框架及生产环境应用过程中,遇到很多底层问题,不过都一一解决,而这些问题能够解决最重要就是 Swoole 开源项目创始人 韩天峰-Rango 的大力支持,在此深表感谢。

责任编辑:未丽燕 来源: Github
相关推荐

2017-09-20 07:37:13

Swoole企业微服务框架

2016-12-15 19:44:23

微服务容器华为HDG

2022-02-20 22:10:20

微服务框架gRPC

2020-04-26 09:00:00

微服务架构软件开发

2021-07-07 10:21:26

技术

2009-12-09 09:57:05

ibmdwJavaPHP

2017-11-07 17:35:44

华为

2018-06-01 23:08:01

Spring Clou微服务服务器

2015-07-29 16:23:07

2018-04-20 10:38:25

2017-05-25 10:32:41

Docker微服务容器

2009-01-13 09:05:45

tomcatSpring框架Web服务器

2017-09-10 16:21:55

微服务API权限

2019-09-18 16:52:58

hyperf微服务php

2019-10-16 08:41:46

微服务架构Nginx

2009-04-29 15:13:43

微软同步框架MSF

2021-03-02 16:25:52

微服务架构技术

2023-02-17 18:06:33

微服务架构

2020-11-27 10:50:06

微服务架构框架

2019-01-31 14:00:03

Java微服务框架
点赞
收藏

51CTO技术栈公众号