Swoole 在 Swoft 中的应用

时间  2019-11-05
标签 swoole swoft 应用 繁體版
原文   原文链接

date: 2017-12-14 21:34:51
title: swoole 在 swoft 中的应用php

swoft 官网: https://www.swoft.org/

swoft 源码解读: http://naotu.baidu.com/file/8...html

号外号外, 欢迎你们 star, 咱们开发组定了一个 star 1000+ 就线下聚一次的小目标mysql

上一篇 blog - swoft 源码解读 反响还不错, 很多同窗推荐再加一篇, 讲解一下 swoft 中使用到的 swoole 功能, 帮助你们开启 swoole 的 实战之旅.nginx

服务器开发涉及到的相关技术领域的知识很是多, 不日积月累打好基础, 是很难真正作好的. 因此我建议:laravel

swoole wiki 最好看 3 遍, 包括评论. 第一遍快速过一遍, 造成大体印象; 第二遍边看边敲代码; 第三遍能够选择衍生的开源框架进行实战. swoft 就是不错的选择.

swoole wiki 发展到如今已经 1400+ 页, 确实会有点难啃, 勇敢的少年呀, 加油.git

swoole 在 swoft 中的应用:github

  • Swoole\Server: swoole2.0 协程 Server
  • Swoole\HttpServer: swoole2.0 协程 http Server, 继承自 Swoole\Server
  • Swoole\Coroutine\Client: 协程客户端, swoole 封装了 tcp / http / redis / mysql
  • Swoole\Coroutine: 协程工具集, 获取当前协程id，反射调用等能力
  • Swoole\Process: 进程管理模块, 能够在 Swoole\Server 以外扩展更多功能
  • Swoole\Async: 异步文件 IO
  • Swoole\Timer: 基于 timerfd + epoll 实现的异步毫秒定时器，可完美的运行在 EventLoop 中
  • Swoole\Event: 直接操做底层 epoll/kqueue 事件循环(EventLoop)的接口
  • Swoole\Lock: 在 PHP 代码中能够很方便地建立一个锁, 用来实现数据同步
  • Swoole\Table: 基于共享内存实现的超高性能数据结构

SwooleHttpServer

使用 swoole 的 http server 相较 tcp server 仍是要简单一些, 只须要关心:web

  • Swoole\Http\Server
  • Swoole\Http\Request
  • Swoole\Http\Response

先看 http server:redis

// \Swoft\Server\HttpServer
public function start()
{
    // http server
    $this->server = new \Swoole\Http\Server($this->httpSetting['host'], $this->httpSetting['port'], $this->httpSetting['model'], $this->httpSetting['type']);

    // 设置事件监听
    $this->server->set($this->setting);
    $this->server->on('start', [$this, 'onStart']);
    $this->server->on('workerStart', [$this, 'onWorkerStart']);
    $this->server->on('managerStart', [$this, 'onManagerStart']);
    $this->server->on('request', [$this, 'onRequest']);
    $this->server->on('task', [$this, 'onTask']);
    $this->server->on('pipeMessage', [$this, 'onPipeMessage']);
    $this->server->on('finish', [$this, 'onFinish']);

    // 启动RPC服务
    if ((int)$this->serverSetting['tcpable'] === 1) {
        $this->listen = $this->server->listen($this->tcpSetting['host'], $this->tcpSetting['port'], $this->tcpSetting['type']);
        $tcpSetting = $this->getListenTcpSetting();
        $this->listen->set($tcpSetting);
        $this->listen->on('connect', [$this, 'onConnect']);
        $this->listen->on('receive', [$this, 'onReceive']);
        $this->listen->on('close', [$this, 'onClose']);
    }

    $this->beforeStart();
    $this->server->start();
}

使用 swoole server 十分简单:sql

  • 传入配置 server 配置信息, new 一个 swoole server
  • 设置事件监听, 这一步须要你们对 swoole 的进程模型很是熟悉, 必定要看懂下面 2 张图
  • 启动服务器

进程流程图

进程/线程结构图

swoft 在使用 http server 时, 还会根据配置信息, 来判断是否同时新建一个 RPC server, 使用 swoole 的 多端口监听 来实现.

再来看 Request 和 Response, 提醒一下, 框架设计的时候, 要记住 规范先行:

PSR-7: HTTP message interfaces

SwooleHttpRequest

phper 比较熟悉的应该是 $_GET $_POST $_COOKIE $_FILES $_SERVER 这些全局变量, 这些在 swoole 中都获得了支持, 而且提供了更多方便的功能:

// \Swoole\Http\Request $request
$request->get(); // -> $_GET
$request->post(); // -> $_POST
$request->cookie(); // -> $_COOKIE
$request->files(); // -> $_FILES
$request->server(); // -> $_SERVER

// 更方便的方法
$request->header(); // 原生 php 须要从 $_SERVER 中取
$request->rawContent(); // 获取原始的POST包体

这里强调一下 $request->rawContent(), phper 可能用 $_POST 比较 6, 致使一些知识不知道: post 的数据的格式. 由于这个知识, 因此 $_POST 不是全部时候都能取到数据的, 你们能够网上查找资料, 或者本身使用 postman 这样的工具本身测试验证一下. 在 $_POST 取不到数据的状况下, 会这样处理:

$post = file_get_content('php://input');

$request->rawContent() 和这个等价的.

swoft 封装 Request 对象的方法, 和主流框架差很少, 以 laravel 为例(实际使用 symfony 的方法):

// SymfonyRequest::createFromGlobals()
public static function createFromGlobals()
{
    // With the php's bug #66606, the php's built-in web server
    // stores the Content-Type and Content-Length header values in
    // HTTP_CONTENT_TYPE and HTTP_CONTENT_LENGTH fields.
    $server = $_SERVER;
    if ('cli-server' === PHP_SAPI) {
        if (array_key_exists('HTTP_CONTENT_LENGTH', $_SERVER)) {
            $server['CONTENT_LENGTH'] = $_SERVER['HTTP_CONTENT_LENGTH'];
        }
        if (array_key_exists('HTTP_CONTENT_TYPE', $_SERVER)) {
            $server['CONTENT_TYPE'] = $_SERVER['HTTP_CONTENT_TYPE'];
        }
    }

    $request = self::createRequestFromFactory($_GET, $_POST, array(), $_COOKIE, $_FILES, $server); // xglobal,

    if (0 === strpos($request->headers->get('CONTENT_TYPE'), 'application/x-www-form-urlencoded')
        && in_array(strtoupper($request->server->get('REQUEST_METHOD', 'GET')), array('PUT', 'DELETE', 'PATCH'))
    ) {
        parse_str($request->getContent(), $data);
        $request->request = new ParameterBag($data);
    }

    return $request;
}

SwooleHttpResponse

Swoole\Http\Response 也是支持常见功能:

// Swoole\Http\Response $response
$response->header($key, $value); // -> header("$key: $valu", $httpCode)
$response->cookie(); // -> setcookie()
$response->status(); // http 状态码

固然, swoole 还提供了经常使用的功能:

$response->sendfile(); // 给客户端发送文件
$response->gzip(); // nginx + fpm 的场景, nginx 处理掉了这个
$response->end(); // 返回数据给客户端
$response->write(); // 分段传输数据, 最后调用 end() 表示数据传输结束

phper 注意下这里的 write() 和 end(), 这里有一个 http chunk 的知识点. 须要返回大量数据给客户端(>=2M)时, 须要分段(chunk)进行发送. 因此先用 write() 发送数据, 最后用 end() 表示结束. 数据量不大时, 直接调用 end($html) 返回就能够了.

在框架具体实现上, 和上面同样, laravel 依旧用的 SymfonyResponse, swoft 也是实现 PSR-7 定义的接口, 对 Swoole\Http\Response 进行封装.

SwooleServer

swoft 使用 Swoole\Server 来实现 RPC 服务, 其实在上面的多端口监听, 也是为了开启 RPC 服务. 注意一下单独启用中回调函数的区别:

// \Swoft\Server\RpcServer
public function start()
{
    // rpc server
    $this->server = new Server($this->tcpSetting['host'], $this->tcpSetting['port'], $this->tcpSetting['model'], $this->tcpSetting['type']);

    // 设置回调函数
    $listenSetting = $this->getListenTcpSetting();
    $setting = array_merge($this->setting, $listenSetting);
    $this->server->set($setting);
    $this->server->on('start', [$this, 'onStart']);
    $this->server->on('workerStart', [$this, 'onWorkerStart']);
    $this->server->on('managerStart', [$this, 'onManagerStart']);
    $this->server->on('task', [$this, 'onTask']);
    $this->server->on('finish', [$this, 'onFinish']);
    $this->server->on('connect', [$this, 'onConnect']);
    $this->server->on('receive', [$this, 'onReceive']);
    $this->server->on('pipeMessage', [$this, 'onPipeMessage']); // 接收管道信息时触发的回调函数
    $this->server->on('close', [$this, 'onClose']);

    // before start
    $this->beforeStart();
    $this->server->start();
}

SwooleCoroutineClient

swoole 自带的协程的客户端, swoft 都封装进了链接池, 用来提升性能. 同时, 为了业务使用方便, 既有协程链接, 也有同步链接, 方便业务使用时无缝切换.

同步/协程链接的实现代码:

// RedisConnect -> 使用 swoole 协程客户端
public function createConnect()
{
    // 链接信息
    $timeout = $this->connectPool->getTimeout();
    $address = $this->connectPool->getConnectAddress();
    list($host, $port) = explode(":", $address);

    // 建立链接
    $redis = new \Swoole\Coroutine\Redis();
    $result = $redis->connect($host, $port, $timeout);
    if ($result == false) {
        App::error("redis链接失败，host=" . $host . " port=" . $port . " timeout=" . $timeout);
        return;
    }

    $this->connect = $redis;
}

// SyncRedisConnect -> 使用 \Redis 同步客户端
public function createConnect()
{
    // 链接信息
    $timeout = $this->connectPool->getTimeout();
    $address = $this->connectPool->getConnectAddress();
    list($host, $port) = explode(":", $address);

    // 初始化链接
    $redis = new \Redis();
    $redis->connect($host, $port, $timeout);
    $this->connect = $redis;
}

swoft 中实现链接池的代码在 src/Pool 下实现, 由三部分组成:

  • Connect: 即上面代码中的链接
  • Balancer: 负载均衡器, 目前实现了 随机/轮询 2 种方式
  • Pool: 链接池, 调用 Balancer, 返回 Connect

详细内容能够参考以前的 blog - swoft 源码解读

SwooleCoroutine

做为首个使用 Swoole2.0 原生协程的框架, swoft 但愿将协程的能力扩展到框架的核心设计中. 使用 Swoft\Base\Coroutine 进行封装, 方便整个应用中使用:

public static function id()
{
    $cid = SwCoroutine::getuid(); // swoole 协程
    $context = ApplicationContext::getContext();

    if ($context == ApplicationContext::WORKER || $cid !== -1) {
        return $cid;
    }
    if ($context == ApplicationContext::TASK) {
        return Task::getId();
    }
    if($context == ApplicationContext::CONSOLE){
        return Console::id();
    }

    return Process::getId();
}

如同这段代码所示, Swoft 但愿将方便易用的协程的能力, 扩展到 Console/Worker/Task/Process 等等不一样的应用场景中

原生的 call_user_func() / call_user_func_array() 中没法使用协程 client, 因此 swoole 在协程组件中也封装的了相应的实现, swoft 中也有使用到, 请自行阅读源码.

SwooleProcess

进程管理模块, 适合处理和 Server 比较独立的常驻进程任务, 在 swoft 中, 在如下场景中使用到:

  • 协程定时器 CronTimerProcess
  • 协程执行命令 CronExecProcess
  • 热更新进程 ReloadProcess

swoft 使用 \Swoft\Process 对 Swoole\Process 进行了封装:

// \Swoft\Process
public static function create(
    AbstractServer $server,
    string $processName,
    string $processClassName
) {
    ...

    // 建立进程
    $process = new SwooleProcess(function (SwooleProcess $process) use ($processClass, $processName) {
        // reload
        BeanFactory::reload();
        $initApplicationContext = new InitApplicationContext();
        $initApplicationContext->init();

        App::trigger(AppEvent::BEFORE_PROCESS, null, $processName, $process, null);
        PhpHelper::call([$processClass, 'run'], [$process]);
        App::trigger(AppEvent::AFTER_PROCESS);
    }, $iout, $pipe); // 启动 \Swoole\Process 并绑定回调函数便可

    return $process;
}

SwooleAsync

swoft 在日志场景下使用 Swoole\Async 来提升性能, 同时保留了原有的同步方式, 方便进行切换

// \Swoft\Log\FileHandler
private function aysncWrite(string $logFile, string $messageText)
{
    while (true) {
        $result = \Swoole\Async::writeFile($logFile, $messageText, null, FILE_APPEND); // 使用起来很简单
        if ($result == true) {
            break;
        }
    }
}

SwooleEvent

服务器出于性能考虑, 一般都是 常驻内存 的, 传统的 php-fpm 也是, 修改了配置须要 reload 服务器才能生效. 也由于此, 服务器领域出现了新的需求 -- 热更新. swoole 在进程管理上已经作了不少优化, 这里摘抄部分 wiki 内容:

Swoole提供了柔性终止/重启的机制
SIGTERM: 向主进程/管理进程发送此信号服务器将安全终止
SIGUSR1: 向主进程/管理进程发送SIGUSR1信号，将平稳地restart全部worker进程

目前你们采用的, 比较常见的方案, 是基于 Linux Inotify 特性, 经过监测文件变动来触发 swoole server reload. PHP 中有 Inotify 扩展, 方便使用, 具体实如今 Swoft\Base\Inotify 中:

public function run()
{
    $inotify = inotify_init();

    // 设置为非阻塞
    stream_set_blocking($inotify, 0);

    $tempFiles = [];
    $iterator = new \RecursiveDirectoryIterator($this->watchDir);
    $files = new \RecursiveIteratorIterator($iterator);
    foreach ($files as $file) {
        $path = dirname($file);

        // 只监听目录
        if (!isset($tempFiles[$path])) {
            $wd = inotify_add_watch($inotify, $path, IN_MODIFY | IN_CREATE | IN_IGNORED | IN_DELETE);
            $tempFiles[$path] = $wd;
            $this->watchFiles[$wd] = $path;
        }
    }

    // swoole Event add
    $this->addSwooleEvent($inotify);
}

private function addSwooleEvent($inotify)
{
    // swoole Event add
    Event::add($inotify, function ($inotify) { // 使用 \Swoole\Event
        // 读取有事件变化的文件
        $events = inotify_read($inotify);
        if ($events) {
            $this->reloadFiles($inotify, $events);
        }
    }, null, SWOOLE_EVENT_READ);
}

SwooleLock

swoft 在 CircuitBreaker(熔断器) 中的 HalfOpenState(半开状态) 使用到了, 而且这块的实现比较复杂, 推荐阅读源码:

// CircuitBreaker
public function init()
{
    // 状态初始化
    $this->circuitState = new CloseState($this);
    $this->halfOpenLock = new \Swoole\Lock(SWOOLE_MUTEX); // 初始化互斥锁
}

// HalfOpenState
public function doCall($callback, $params = [], $fallback = null)
{
    // 加锁
    $lock = $this->circuitBreaker->getHalfOpenLock();
    $lock->lock();
    list($class ,$method) = $callback;

    ....

    // 释放锁
    $lock->unlock();

    ...
}

锁的使用, 难点主要在了解各类不一样锁使用的场景, 目前 swoole 支持:

  • 文件锁 SWOOLE_FILELOCK
  • 读写锁 SWOOLE_RWLOCK
  • 信号量 SWOOLE_SEM
  • 互斥锁 SWOOLE_MUTEX
  • 自旋锁 SWOOLE_SPINLOCK

SwooleTimer & SwooleTable

定时器基本都会使用到, phper 用的比较多的应该是 crontab 了. 基于这个考虑, swoft 对 Timer 进行了封装, 方便 phper 用 熟悉的姿式 继续使用.

swoft 对 Swoole\Timer 进行了简单的封装, 代码在 \Base\Timer 中:

// 设置定时器
public function addTickTimer(string $name, int $time, $callback, $params = [])
{
    array_unshift($params, $name, $callback);

    $tid = \Swoole\Timer::tick($time, [$this, 'timerCallback'], $params);

    $this->timers[$name][$tid] = $tid;

    return $tid;
}

// 清除定时器
public function clearTimerByName(string $name)
{
    if (!isset($this->timers[$name])) {
        return true;
    }
    foreach ($this->timers[$name] as $tid => $tidVal) {
        \Swoole\Timer::clear($tid);
    }
    unset($this->timers[$name]);

    return true;
}

Swoole\Table 是在内存中开辟一块区域, 实现相似关系型数据库表(Table)这样的数据结构, 关于 Swoole\Table 的实现原理, rango 写过专门的文章 swoole_table 实现原理剖析, 推荐阅读.

Swoole\Table 在使用上须要注意如下几点:

  • 相似关系型数据库, 须要提早定义好 表结构
  • 须要预先判断数据的大小(行数)
  • 注意内存, swoole 会更根据上面 2 个定义, 在调用 \Swoole\Table->create() 时分配掉这些内存

swoft 中则是使用这一功能, 来实现 crontab 方式的任务调度:

private $originTable;
private $runTimeTable;

private $originStruct = [
    'rule'       => [\Swoole\Table::TYPE_STRING, 100],
    'taskClass'  => [\Swoole\Table::TYPE_STRING, 255],
    'taskMethod' => [\Swoole\Table::TYPE_STRING, 255],
    'add_time'   => [\Swoole\Table::TYPE_STRING, 11],
];

private $runTimeStruct = [
    'taskClass'  => [\Swoole\Table::TYPE_STRING, 255],
    'taskMethod' => [\Swoole\Table::TYPE_STRING, 255],
    'minte'      => [\Swoole\Table::TYPE_STRING, 20],
    'sec'        => [\Swoole\Table::TYPE_STRING, 20],
    'runStatus'  => [\Swoole\TABLE::TYPE_INT, 4],
];

// 使用 \Swoole\Table
private function createOriginTable(): bool
{
    $this->setOriginTable(new \Swoole\Table('origin', self::TABLE_SIZE, $this->originStruct));

    return $this->getOriginTable()->create();
}

写在最后

老生常谈了, 不少人吐槽 swoole 坑, 文档很差. 说句实话, 要勇于直面本身服务器开发能力不足的现实. 我常常提的一句话:

要把 swoole 的 wiki 看 3 遍.

写这篇 blog 的初衷是给你们介绍一下 swoole 在 swoft 中的应用场景, 帮助你们尝试进行 swoole 落地. 但愿这篇 blog 能对你有所帮助, 也但愿你能多多关注 swoole 社区, 关注 swoft 框架, 能感觉到服务器开发带来的乐趣.

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程