【PHP】PHP 微服务协程框架Swoft

 简介

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

　　Swoft是基于Swoole开发的，如果不了解Swoole的可以看看我之前写的文章Swoole高性能框架。

　　官网地址：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.不要再控制器写基类来写公共的变量，这样会造成数据污染，当下一个请求进来依然会请求到这个变量，因为常驻内存并且单利所以不会释放掉。

 　　官方文档也有提示

　　

　　　　 https://www.swoft.org/documents/v2/dev-guide/dev-note/

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过程中根据@Bean注解去获取类的实例，然后再将实例装载到Bean容器中，在需要的时候在根据命令去调用这些实例对象。下图就是这个过程示意图。

 　　

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