PHP之微服务协程框架Swoft

简介

　　有了swoole这样强大的扩展之后，越来越多的框架都是基于swoole被开发出来，Swoft就是其中一款不错的PHP框架。Swoft 是一款基于 Swoole 原生协程的注解式框架，自带常驻内存以及 Swoole 其它功能的封装。swoft中内置了协程客户端。同时swoft里面有了很多新的概念，比如Aop等。

　　官网地址：https://www.swoft.org/

使用Swoft框架注意事项

　　因为Swoft是基于Swoole，所以和普通的PHP框架还是很不一样的，有些是需要注意的。

　　1.不要再代码中执行sleep()以及其他睡眠函数，这样会导致整个进程阻塞。

　　2.不要使用exit/die函数，这样会导致worker进程直接退出。

　　3.进程隔离需要注意的，当修改了全局变量的值，会不生效，因为全局变量在不同的进程中，内存空间是隔离的。使用Swoft框架需要了解进程隔离问题。不同的进程中PHP变量不是共享，即便是全局变量。如果不同的进程需要共享数据，可以使用Redis，Mysql，消息队列，文件，Swoole/Table，APCu（php自带的缓存扩展），shmget（进程通信(IPC)共享内存）等工具。同时不同进程的文件句柄也是隔离的，所以在A进程创建的Socker连接打开的文件在B进程内是无效的。

　　4.进程克隆，当server启动时候，主进程会克隆当前进程状态，此后开始进程内的数据互相独立，互不影响。

　　5.不要再控制器写基类来写公共的变量，这样会造成数据污染，当下一个请求进来依然会请求到这个变量，因为常驻内存并且单利所以不会释放掉。

　　官方文档也有提示

Swoft框架安装

　　安装环境要求：

　　　　1. gcc版本大于等于4.8。

　　　　2. PHP版本大于7.1。

　　　　3. Composer包管理工具。

　　　　4. 安装Redis异步客户端hiredis，在最新版本的Swoole4.2.6之后已经内置了，不需要安装。

　　　　5. Swoole扩展，这个是必须的。

　　　　6.链接迭代器依赖库pcre。

　　　　7. Swoole需要开启协程和异步redis。

　　安装

git clone https://github.com/swoft-cloud/swoft cd swoft composer install cp .env.example .env   #编辑 .env 文件，根据需要调整相关环境配置

如果出现下面错误说明redis扩展没有，因为swoft需要redis扩展。

当然使用docker方式会更加简单，执行下面命令

docker run -p 18306:18306 --name swoft swoft/swoft

在浏览器中输入 http://127.0.0.1:18306 就可以打开Swoft本地页面。

关闭和开启运行命令 docker start/stop swoft

Swoft目录及文件说明

进入容器查看swoft目录

root@880c142615c3:/var/www/swoft# tree -L 2 . |-- CONTRIBUTING.md |-- Dockerfile |-- LICENSE |-- README.md |-- README.zh-CN.md |-- app                        #应用目录 |   |-- Annotation　　　　　　　 #定义注解相关目录|   |-- Application.php |   |-- Aspect |   |-- AutoLoader.php |   |-- Common |   |-- Console |   |-- Exception |   |-- Helper　　　　　　　　　　#助手函数目录 |   |-- Http |   |-- Listener　　　　　　　　 #事件监听器目录|   |-- Migration |   |-- Model　　　　　　　　　　 #模型、逻辑等代码目录|   |-- Process |   |-- Rpc　　　　　　　　　　　　#RPC服务代码目录|   |-- Task　　　　　　　　　　　 #任务投递管理目录，这里可以做异步任务或者定时器的工作 |   |-- Tcp |   |-- Validator |   |-- WebSocket　　　　　　　　 #WebSocket服务代码目录|   `-- bean.php |-- bin |   |-- bootstrap.php |   `-- swoft　　　　　　　　　　  #Swoft入口文件|-- composer.cn.json |-- composer.json |-- composer.lock |-- config |   |-- base.php |   |-- db.php |   `-- dev |-- database |   |-- AutoLoader.php |   `-- Migration |-- dev.composer.json |-- docker-compose.yml |-- phpstan.neon.dist |-- phpunit.xml |-- public |   |-- favicon.ico |   `-- image |-- resource                   #应用资源目录|   |-- language |   `-- views |-- runtime　　　　　　　　　　   #临时文件目录（日志、上传文件、文件缓存等）|   |-- logs |   |-- sessions |   |-- swoft.command |   `-- swoft.pid |-- test　　　　　　　　　　　　　 #单元测试目录　　　 |   |-- apitest |   |-- bootstrap.php |   |-- run.php |   |-- testing |   `-- unit `-- vendor     |-- autoload.php     |-- bin     |-- composer     |-- doctrine     |-- monolog     |-- myclabs     |-- nikic     |-- phar-io     |-- php-di     |-- phpdocumentor     |-- phpoption     |-- phpspec     |-- phpunit     |-- psr     |-- sebastian     |-- swoft     |-- symfony     |-- text     |-- theseer     |-- toolkit     |-- vlucas     `-- webmozart

SwoftBean容器

　　　Bean容器是Swoft的核心，每一个Bean就是一个类对象的实例，容器就是一个工厂来存放和管理Bean。在HttpServer启动时候会扫描带有@Bean注解的类。传统的PHP是没有常驻内存的，每次请求都会重新初始化各种资源，每个对象也要重新实例化去申请内存，处理完请求后又被消耗，十分浪费资源。而Swoft在HttpServer启动后会将这些对象实例化并存放在内存中，下次请求就直接取出使用，减少对象创建资源的消耗。

　　 Bean容器底层是一个BeanFactory管理容器（Container）。

Swoft注解(Annotations)机制

注解是Swoft里面很多重要功能特别是AOP，IoC容器的基础。熟悉Java的朋友应该更加了解注解。　

那么注解是什么样呢？下面是Swoft的一部分代码，在类、方法或成员变量上方的注释部分就有注解。

namespace AppTcpController;  use AppTcpMiddlewareDemoMiddleware; use SwoftTcpServerAnnotationMappingTcpController; use SwoftTcpServerAnnotationMappingTcpMapping; use SwoftTcpServerRequest; use SwoftTcpServerResponse; use function strrev;  /**  * Class DemoController  *  * @TcpController(middlewares={DemoMiddleware::class})      #这个就是注解  */ class DemoController {     /**      * @TcpMapping("list", root=true)      * @param Response $response      */     public function list(Response $response): void     {         $response->setData('[list]allow command: list, echo, demo.echo');     }

　　注解是什么呢？有什么作用呢？

　　　　注解其实是通过反射把注释当成代码的一部分，PHP可以通过ReflectionClass来获取一个类的信息，从而了解类里的信息，比如获取类中的所有方法、成员变量，并包括私有方法等，并根据这些信息实现一些操作。像很多PHP框架，比如laravel框架就利用PHP的反射机制来实现依赖注入。

　　　　其实注解是配置的另一种方式，这里注解就可以起到一个配置作用。比如定义路由，定义配置定时任务，权限控制等。

　　　　在Swoft中要是使用注解，需引入相关注解（Annotation）类，且必须以 /** 开始并以 */ 结束，否则会导致无法解析！

Aop切面编程

　　Aop介绍

　　　　1. Aspect（切面）：通常是一个类，里面可以定义切入点和通知。

　　　　2. JointPoint（连接点）：程序执行过程中明确的点，一般是方法的调用。

　　　　3. Advice（通知）：Aop在特定的切入点执行的增强处理，有before，after，afterReturning，afterThrowing，around。

　　　　4. Pointcut（切入点）：就是嗲有通知的连接点，在程序中主要体现为书写切入点表达式。

　　 Swoft新版的Aop设计建立在PHP Parser上面。

　　　　PHP-Parser的项目主页是：https://github.com/nikic/PHP-Parser

推荐教程：《php教程》