EasySwoole 基础入门

来源:凉官灰 发布时间:2020-05-25 09:55:09 阅读量:1074

使用 Composer 安装

1

2

composer require easyswoole/easyswoole=3.x

php vendor/bin/easyswoole install

启动框架

1

php easyswoole start

nginx转发

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

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

1

2

3

4

5

6

project              项目部署目录

----------------------------------

├─App        应用目录

│  └─HttpController      应用的控制器目录

│     └─Index.php    默认控制器文件

----------------------------------

Index.php

1

2

3

4

5

6

7

8

9

10

11

<?php

namespace App\HttpController;

use EasySwoole\Http\AbstractInterface\Controller;

class Index extends Controller

{

    function index()

    {

        // TODO: Implement index() method.

        $this->response()->write('hello world');

    }

}

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

1

2

3

4

5

6

7

8

9

10

{

    "autoload": {

        "psr-4": {

            "App\\": "App/"

        }

    },

    "require": {

        "easyswoole/easyswoole": "3.x-dev"

    }

}

意思就是设置自动加载

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

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

# 更新命名空间映射

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             生产配置文件

生命周期,也就是流程

10865887-bd0a50f622948627.png

配置文件说明

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

<?php

      /**

       * Created by PhpStorm.

       * User: yf

       * Date: 2019-01-01

       * Time: 20:06

       */

      return [

          'SERVER_NAME'   => "EasySwoole",//服务名

          'MAIN_SERVER'   => [

              'LISTEN_ADDRESS' => '0.0.0.0',//监听地址

              'PORT'           => 9501,//监听端口

              'SERVER_TYPE'    => EASYSWOOLE_WEB_SERVER, //可选为 EASYSWOOLE_SERVER  EASYSWOOLE_WEB_SERVER EASYSWOOLE_WEB_SOCKET_SERVER

              'SOCK_TYPE'      => SWOOLE_TCP,//该配置项当为SERVER_TYPE值为TYPE_SERVER时有效

              'RUN_MODEL'      => SWOOLE_PROCESS,// 默认Server的运行模式

              'SETTING'        => [// Swoole Server的运行配置( 完整配置可见[Swoole文档](https://wiki.swoole.com/wiki/page/274.html) )

                  'worker_num'       => 8,//运行的  worker进程数量

                  'max_request'      => 5000,// worker 完成该数量的请求后将退出,防止内存溢出

                  'task_worker_num'  => 8,//运行的 task_worker 进程数量

                  'task_max_request' => 1000,// task_worker 完成该数量的请求后将退出,防止内存溢出

                  'reload_async' => true,//设置异步重启开关。设置为true时,将启用异步安全重启特性,Worker进程会等待异步事件完成后再退出。

                  'task_enable_coroutine' => true//开启后自动在onTask回调中创建协程

              ]

          ],

          'TEMP_DIR'      => null,//临时文件存放的目录

          'LOG_DIR'       => null,//日志文件存放的目录

          'CONSOLE'       => [//console控制台组件配置

              'ENABLE'         => true,//是否开启

              'LISTEN_ADDRESS' => '127.0.0.1',//监听地址

              'PORT'           => 9500,//监听端口

              'USER'           => 'root',//验权用户名

              'PASSWORD'       => '123456'//验权用户名

          ],

          'FAST_CACHE'    => [//fastCache组件

              'PROCESS_NUM' => 0,//进程数,大于0才开启

              'BACKLOG'     => 256,//数据队列缓冲区大小

          ],

          'DISPLAY_ERROR' => true,//是否开启错误显示

      ];

配置操作类

EasySwoole\Config 类

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

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

1

2

3

4

5

6

7

8

9

10

11

12

13

14

<?php

$instance = \EasySwoole\EasySwoole\Config::getInstance();

// 获取配置 按层级用点号分隔

$instance->getConf('MAIN_SERVER.SETTING.task_worker_num');

// 设置配置 按层级用点号分隔

$instance->setConf('DATABASE.host', 'localhost');

// 获取全部配置

$conf = $instance->getConf();

// 用一个数组覆盖当前配置项

$conf['DATABASE'] = [

    'host' => '127.0.0.1',

    'port' => 13306

];

$instance->load($conf);

添加用户配置项

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

'MYSQL' => [

    'host'          => '192.168.75.1',

    'port'          => '3306',

    'user'          => 'root',

    'timeout'       => '5',

    'charset'       => 'utf8mb4',

    'password'      => 'root',

    'database'      => 'cry',

    'POOL_MAX_NUM'  => '20',

    'POOL_TIME_OUT' => '0.1',

],

/*################ REDIS CONFIG ##################*/

'REDIS' => [

    'host'          => '127.0.0.1',

    'port'          => '6379',

    'auth'          => '',

    'POOL_MAX_NUM'  => '20',

    'POOL_MIN_NUM'  => '5',

    'POOL_TIME_OUT' => '0.1',

],

生产与开发配置分离

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

生成

1

php easyswoole start produce

DI注入配置

也就是依赖注入

1

2

3

4

5

6

7

<?php

Di::getInstance()->set(SysConst::ERROR_HANDLER,function (){});//配置错误处理回调

Di::getInstance()->set(SysConst::SHUTDOWN_FUNCTION,function (){});//配置脚本结束回调

Di::getInstance()->set(SysConst::HTTP_CONTROLLER_NAMESPACE,'App\\HttpController\\');//配置控制器命名空间

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控制器对象池最大数量

动态配置

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

1

2

3

4

<?php

    Config::getInstance()->setDynamicConf('test_config_value', 0);//配置一个动态配置项

    $test_config_value_1 = Config::getInstance()->getDynamicConf('test_config_value');//获取一个配置

    Config::getInstance()->delDynamicConf('test_config_value');//删除一个配置

服务管理脚本

1

2

3

4

5

6

7

php easyswoole

 install       安装easySwoole

  start         启动easySwoole

  stop          停止easySwoole(守护模式下使用)

  reload        重启easySwoole(守护模式下使用)

  help          查看命令的帮助信息

easyswoole help -start

守护模式启动

1

php easyswoole start d

线上

1

php easyswoole start produce

停止

1

php easyswoole stop

重启服务

1

2

php easyswoole reload 只重启task进程

php easyswoole reload all  重启task + worker进程

文件热加载

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

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

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

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

<?php

/**

 * Created by PhpStorm.

 * User: evalor

 * Date: 2018-11-26

 * Time: 23:18

 */

namespace App\Process;

use EasySwoole\Component\Process\AbstractProcess;

use EasySwoole\EasySwoole\ServerManager;

use EasySwoole\Utility\File;

use Swoole\Process;

use Swoole\Table;

use Swoole\Timer;

/**

 * 暴力热重载

 * Class HotReload

 * @package App\Process

 */

class HotReload extends AbstractProcess

{

    /** @var \swoole_table $table */

    protected $table;

    protected $isReady = false;

    protected $monitorDir; // 需要监控的目录

    protected $monitorExt; // 需要监控的后缀

    /**

     * 启动定时器进行循环扫描

     */

    public function run($arg)

    {

        // 此处指定需要监视的目录 建议只监视App目录下的文件变更

        $this->monitorDir = !empty($arg['monitorDir']) ? $arg['monitorDir'] : EASYSWOOLE_ROOT . '/App';

        // 指定需要监控的扩展名 不属于指定类型的的文件 无视变更 不重启

        $this->monitorExt = !empty($arg['monitorExt']) && is_array($arg['monitorExt']) ? $arg['monitorExt'] : ['php'];

        if (extension_loaded('inotify') && empty($arg['disableInotify'])) {

            // 扩展可用 优先使用扩展进行处理

            $this->registerInotifyEvent();

            echo "server hot reload start : use inotify\n";

        } else {

            // 扩展不可用时 进行暴力扫描

            $this->table = new Table(512);

            $this->table->column('mtime', 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, ['mtime' => $mtime]);

                    $doReload = true;

                } else {

                    // 修改文件 但未发生inode变更

                    $oldTime = $this->table->get($inode)['mtime'];