topthink/think-swoole

Swoole extend for thinkphp

v4.0.12 2023-11-17 13:00 UTC

Requires

• php: ^8.0
• ext-json: *
• ext-swoole: >=4.6
• nette/php-generator: ^4.0
• open-smf/connection-pool: >=1.0
• stechstudio/backoff: ^1.2
• swoole/ide-helper: ^4.3
• symfony/finder: ^4.3.2|^5.1
• topthink/framework: ^6.0|^8.0

Requires (Dev)

• phpunit/phpunit: ^9.5
• symfony/var-dumper: ^4.3|^5.1
• topthink/think-queue: ^3.0
• topthink/think-tracing: ^1.0

Apache-2.0

• liu21st

README

交流群：787100169

安装

首先按照Swoole官网说明安装swoole扩展，然后使用

composer require topthink/think-swoole

安装swoole扩展。

使用方法

直接在命令行下启动HTTP服务端。

php think swoole

启动完成后，默认会在0.0.0.0:8080启动一个HTTP Server，可以直接访问当前的应用。

swoole的相关参数可以在config/swoole.php里面配置（具体参考配置文件内容）。

如果需要使用守护进程方式运行，建议使用supervisor来管理进程

访问静态文件

4.0开始协程风格服务端默认不支持静态文件访问，建议使用nginx来支持静态文件访问，也可使用路由输出文件内容，下面是示例，可参照修改

1. 添加静态文件路由：

Route::get('static/:path', function (string $path) {
    $filename = public_path() . $path;
    return new \think\swoole\response\File($filename);
})->pattern(['path' => '.*\.\w+$']);

1. 访问路由 http://localhost/static/文件路径

队列支持

4.0开始协程风格服务端没有task进程了，使用think-queue代替

使用方法见 think-queue

以下配置代替think-queue里的最后一步:监听任务并执行,无需另外起进程执行队列

return [
    // ...
    'queue'      => [
        'enable'  => true,
        //键名是队列名称
        'workers' => [
            //下面参数是不设置时的默认配置
            'default'            => [
                'delay'      => 0,
                'sleep'      => 3,
                'tries'      => 0,
                'timeout'    => 60,
                'worker_num' => 1,
            ],
            //使用@符号后面可指定队列使用驱动
            'default@connection' => [
                //此处可不设置任何参数，使用上面的默认配置
            ],
        ],
    ],
    // ...
];

支持symfony/var-dumper

由于应用是通过php cli启动的，所以默认symfony/var-dumper会将调试信息打印在控制台, 通过配置中间件来支持将调试信息输出在网页上 如下是直接在配置在全局中间件上，也可以在路由定义的时候配置

// app/middleware.php

<?php
// 全局中间件定义文件
return [
    // 全局请求缓存
    // \think\middleware\CheckRequestCache::class,
    // 多语言加载
    // \think\middleware\LoadLangPack::class,
    // Session初始化
    //\think\middleware\SessionInit::class,
    \think\swoole\middleware\InteractsWithVarDumper::class,
];