EasySwoole基础入门

composer require easyswoole/easyswoole=3.x
php vendor/bin/easyswoole install

启动框架

php easyswoole start

nginx转发

server {
    root /data/wwwroot/;
    server_name local.easyswoole.com;
 
    location / {
        proxy_http_version 1.1;
        proxy_set_header Connection "keep-alive";
        proxy_set_header X-Real-IP $remote_addr;
        if (!-e $request_filename) {
             proxy_pass http://127.0.0.1:9501;
        }
        if (!-f $request_filename) {
             proxy_pass http://127.0.0.1:9501;
        }
    }
}

proxy_set_header X-Real-IP $remote_addr; 获取真实IP地址

运行你的hellword

project              项目部署目录
----------------------------------
├─App        应用目录
│  └─HttpController      应用的控制器目录
│     └─Index.php    默认控制器文件
----------------------------------

Index.php

response()->write(&＃39;hello world&＃39;);
    }
}

编辑根目录下的 composer.json 文件，注册应用的命名空间

{
    "autoload": {
        "psr-4": {
            "App\\": "App/"
        }
    },
    "require": {
        "easyswoole/easyswoole": "3.x-dev"
    }
}

意思就是设置自动加载

最后执行composer dumpautoload 命令更新命名空间，可以开始编写业务逻辑

# 更新命名空间映射
composer dumpautoload
# 启动框架
php easyswoole start
目录结构
project                   项目部署目录
├─App                     应用目录(可以有多个)
│  ├─HttpController       控制器目录
│  │  └─Index.php         默认控制器
│  └─Model                模型文件目录
├─Log                     日志文件目录
├─Temp                    临时文件目录
├─vendor                  第三方类库目录
├─composer.json           Composer架构
├─composer.lock           Composer锁定
├─EasySwooleEvent.php     框架全局事件
├─easyswoole              框架管理脚本
├─easyswoole.install      框架安装锁定文件
├─dev.php                 开发配置文件
├─produce.php             生产配置文件

生命周期，也就是流程

配置文件说明

 "EasySwoole",//服务名
          &＃39;MAIN_SERVER&＃39;   => [
              &＃39;LISTEN_ADDRESS&＃39; => &＃39;0.0.0.0&＃39;,//监听地址
              &＃39;PORT&＃39;           => 9501,//监听端口
              &＃39;SERVER_TYPE&＃39;    => EASYSWOOLE_WEB_SERVER, //可选为 EASYSWOOLE_SERVER  EASYSWOOLE_WEB_SERVER EASYSWOOLE_WEB_SOCKET_SERVER
              &＃39;SOCK_TYPE&＃39;      => SWOOLE_TCP,//该配置项当为SERVER_TYPE值为TYPE_SERVER时有效
              &＃39;RUN_MODEL&＃39;      => SWOOLE_PROCESS,// 默认Server的运行模式
              &＃39;SETTING&＃39;        => [// Swoole Server的运行配置（ 完整配置可见[Swoole文档](https://wiki.swoole.com/wiki/page/274.html) ）
                  &＃39;worker_num&＃39;       => 8,//运行的  worker进程数量
                  &＃39;max_request&＃39;      => 5000,// worker 完成该数量的请求后将退出，防止内存溢出
                  &＃39;task_worker_num&＃39;  => 8,//运行的 task_worker 进程数量
                  &＃39;task_max_request&＃39; => 1000,// task_worker 完成该数量的请求后将退出，防止内存溢出
                  &＃39;reload_async&＃39; => true,//设置异步重启开关。设置为true时，将启用异步安全重启特性，Worker进程会等待异步事件完成后再退出。
                  &＃39;task_enable_coroutine&＃39; => true//开启后自动在onTask回调中创建协程
              ]
          ],
          &＃39;TEMP_DIR&＃39;      => null,//临时文件存放的目录
          &＃39;LOG_DIR&＃39;       => null,//日志文件存放的目录
          &＃39;CONSOLE&＃39;       => [//console控制台组件配置
              &＃39;ENABLE&＃39;         => true,//是否开启
              &＃39;LISTEN_ADDRESS&＃39; => &＃39;127.0.0.1&＃39;,//监听地址
              &＃39;PORT&＃39;           => 9500,//监听端口
              &＃39;USER&＃39;           => &＃39;root&＃39;,//验权用户名
              &＃39;PASSWORD&＃39;       => &＃39;123456&＃39;//验权用户名
          ],
          &＃39;FAST_CACHE&＃39;    => [//fastCache组件
              &＃39;PROCESS_NUM&＃39; => 0,//进程数,大于0才开启
              &＃39;BACKLOG&＃39;     => 256,//数据队列缓冲区大小
          ],
          &＃39;DISPLAY_ERROR&＃39; => true,//是否开启错误显示
      ];

配置操作类

EasySwoole\Config 类

toArray 方法获取全部配置，load 方法重载全部配置

如果设置了修改，需要更新配置的意思

getConf(&＃39;MAIN_SERVER.SETTING.task_worker_num&＃39;);
// 设置配置 按层级用点号分隔
$instance->setConf(&＃39;DATABASE.host&＃39;, &＃39;localhost&＃39;);
// 获取全部配置
$cOnf= $instance->getConf();
// 用一个数组覆盖当前配置项
$conf[&＃39;DATABASE&＃39;] = [
    &＃39;host&＃39; => &＃39;127.0.0.1&＃39;,
    &＃39;port&＃39; => 13306
];
$instance->load($conf);

添加用户配置项

&＃39;MYSQL&＃39; => [
    &＃39;host&＃39;          => &＃39;192.168.75.1&＃39;,
    &＃39;port&＃39;          => &＃39;3306&＃39;,
    &＃39;user&＃39;          => &＃39;root&＃39;,
    &＃39;timeout&＃39;       => &＃39;5&＃39;,
    &＃39;charset&＃39;       => &＃39;utf8mb4&＃39;,
    &＃39;password&＃39;      => &＃39;root&＃39;,
    &＃39;database&＃39;      => &＃39;cry&＃39;,
    &＃39;POOL_MAX_NUM&＃39;  => &＃39;20&＃39;,
    &＃39;POOL_TIME_OUT&＃39; => &＃39;0.1&＃39;,
],
/*################ REDIS CONFIG ##################*/
&＃39;REDIS&＃39; => [
    &＃39;host&＃39;          => &＃39;127.0.0.1&＃39;,
    &＃39;port&＃39;          => &＃39;6379&＃39;,
    &＃39;auth&＃39;          => &＃39;&＃39;,
    &＃39;POOL_MAX_NUM&＃39;  => &＃39;20&＃39;,
    &＃39;POOL_MIN_NUM&＃39;  => &＃39;5&＃39;,
    &＃39;POOL_TIME_OUT&＃39; => &＃39;0.1&＃39;,
],

生产与开发配置分离

默认为开发模式,加载 dev.php

生成

php easyswoole start produce

DI注入配置

也就是依赖注入

set(SysConst::ERROR_HANDLER,function (){});//配置错误处理回调
Di::getInstance()->set(SysConst::SHUTDOWN_FUNCTION,function (){});//配置脚本结束回调
Di::getInstance()->set(SysConst::HTTP_CONTROLLER_NAMESPACE,&＃39;App\\HttpController\\&＃39;);//配置控制器命名空间
Di::getInstance()->set(SysConst::HTTP_CONTROLLER_MAX_DEPTH,5);//配置http控制器最大解析层级
Di::getInstance()->set(SysConst::HTTP_EXCEPTION_HANDLER,function (){});//配置http控制器异常回调
Di::getInstance()->set(SysConst::HTTP_CONTROLLER_POOL_MAX_NUM,15);//http控制器对象池最大数量

动态配置

每次开始了，是上一次的进程，比如你打开了旧版，现在更新了新版，但是旧版还是开着，没有重启动，也就是一直旧版，现在有个动态配置，表示可以平滑的修改

setDynamicConf(&＃39;test_config_value&＃39;, 0);//配置一个动态配置项
    $test_config_value_1 = Config::getInstance()->getDynamicConf(&＃39;test_config_value&＃39;);//获取一个配置
    Config::getInstance()->delDynamicConf(&＃39;test_config_value&＃39;);//删除一个配置

服务管理脚本

php easyswoole
 install       安装easySwoole
  start         启动easySwoole
  stop          停止easySwoole(守护模式下使用)
  reload        重启easySwoole(守护模式下使用)
  help          查看命令的帮助信息
easyswoole help -start

守护模式启动

php easyswoole start d

线上

php easyswoole start produce

停止

php easyswoole stop

重启服务

php easyswoole reload 只重启task进程
php easyswoole reload all  重启task + worker进程

文件热加载

由于 swoole 常驻内存的特性，修改文件后需要重启worker进程才能将被修改的文件重新载入内存中

解决：Process的方式实现文件变动自动进行服务重载

新建文件 App/Process/HotReload.php 并添加如下内容，也可以放在其他位置，请对应命名空间

mOnitorDir= !empty($arg[&＃39;monitorDir&＃39;]) ? $arg[&＃39;monitorDir&＃39;] : EASYSWOOLE_ROOT . &＃39;/App&＃39;;
        // 指定需要监控的扩展名 不属于指定类型的的文件 无视变更 不重启
        $this->mOnitorExt= !empty($arg[&＃39;monitorExt&＃39;]) && is_array($arg[&＃39;monitorExt&＃39;]) ? $arg[&＃39;monitorExt&＃39;] : [&＃39;php&＃39;];
        if (extension_loaded(&＃39;inotify&＃39;) && empty($arg[&＃39;disableInotify&＃39;])) {
            // 扩展可用 优先使用扩展进行处理
            $this->registerInotifyEvent();
            echo "server hot reload start : use inotify\n";
        } else {
            // 扩展不可用时 进行暴力扫描
            $this->table = new Table(512);
            $this->table->column(&＃39;mtime&＃39;, Table::TYPE_INT, 4);
            $this->table->create();
            $this->runComparison();
            Timer::tick(1000, function () {
                $this->runComparison();
            });
            echo "server hot reload start : use timer tick comparison\n";
        }
    }
    /**
     * 扫描文件变更
     */
    private function runComparison()
    {
        $startTime = microtime(true);
        $doReload = false;
        $dirIterator = new \RecursiveDirectoryIterator($this->monitorDir);
        $iterator = new \RecursiveIteratorIterator($dirIterator);
        $inodeList = array();
        // 迭代目录全部文件进行检查
        foreach ($iterator as $file) {
            /** @var \SplFileInfo $file */
            $ext = $file->getExtension();
            if (!in_array($ext, $this->monitorExt)) {
                continue; // 只检查指定类型
            } else {
                // 由于修改文件名称 并不需要重新载入 可以基于inode进行监控
                $inode = $file->getInode();
                $mtime = $file->getMTime();
                array_push($inodeList, $inode);
                if (!$this->table->exist($inode)) {
                    // 新建文件或修改文件 变更了inode
                    $this->table->set($inode, [&＃39;mtime&＃39; => $mtime]);
                    $doReload = true;
                } else {
                    // 修改文件 但未发生inode变更
                    $oldTime = $this->table->get($inode)[&＃39;mtime&＃39;];
                    if ($oldTime != $mtime) {
                        $this->table->set($inode, [&＃39;mtime&＃39; => $mtime]);
                        $doReload = true;
                    }
                }
            }
        }
        foreach ($this->table as $inode => $value) {
            // 迭代table寻找需要删除的inode
            if (!in_array(intval($inode), $inodeList)) {
                $this->table->del($inode);
                $doReload = true;
            }
        }
        if ($doReload) {
            $count = $this->table->count();
            $time = date(&＃39;Y-m-d H:i:s&＃39;);
            $usage = round(microtime(true) - $startTime, 3);
            if (!$this->isReady == false) {
                // 监测到需要进行热重启
                echo "severReload at {$time} use : {$usage} s total: {$count} files\n";
                ServerManager::getInstance()->getSwooleServer()->reload();
            } else {
                // 首次扫描不需要进行重启操作
                echo "hot reload ready at {$time} use : {$usage} s total: {$count} files\n";
                $this->isReady = true;
            }
        }
    }
    /**
     * 注册Inotify监听事件
     */
    private function registerInotifyEvent()
    {
        // 因为进程独立 且当前是自定义进程 全局变量只有该进程使用
        // 在确定不会造成污染的情况下 也可以合理使用全局变量
        global $lastReloadTime;
        global $inotifyResource;
        $lastReloadTime = 0;
        $files = File::scanDirectory(EASYSWOOLE_ROOT . &＃39;/App&＃39;);
        $files = array_merge($files[&＃39;files&＃39;], $files[&＃39;dirs&＃39;]);
        $inotifyResource = inotify_init();
        // 为当前所有的目录和文件添加事件监听
        foreach ($files as $item) {
            inotify_add_watch($inotifyResource, $item, IN_CREATE | IN_DELETE | IN_MODIFY);
        }
        // 加入事件循环
        swoole_event_add($inotifyResource, function () {
            global $lastReloadTime;
            global $inotifyResource;
            $events = inotify_read($inotifyResource);
            if ($lastReloadTime getSwooleServer()->reload();
            }
        });
    }
    public function onShutDown()
    {
        // TODO: Implement onShutDown() method.
    }
    public function onReceive(string $str)
    {
        // TODO: Implement onReceive() method.
    }
}

添加好后在全局的 EasySwooleEvent.php 中，注册该自定义进程

public static function mainServerCreate(EventRegister $register)
{
    $swooleServer = ServerManager::getInstance()->getSwooleServer();
    $swooleServer->addProcess((new HotReload(&＃39;HotReload&＃39;, [&＃39;disableInotify&＃39; => false]))->getProcess());
}

以上就是EasySwoole 基础入门的详细内容，更多请关注 第一PHP社区 其它相关文章！