evotide/openswoole-bundle

Swoole Symfony Bundle

v0.12.0 2022-12-26 18:35 UTC

README

Maintainability Test Coverage Open Source Love MIT Licence

使用Swoole加速你的应用,与Swoole集成Symfony。

构建矩阵

目录

快速入门指南

  1. 确保您已安装适当的Swoole PHP扩展并满足其他需求

  2. (可选) 创建一个新的symfony项目

    composer create-project symfony/skeleton project
    
    cd ./project
  3. 在您的Symfony应用程序中安装包

    composer require k911/swoole-bundle
  4. 编辑config/bundles.php

    return [
        // ...other bundles
        K911\Swoole\Bridge\Symfony\Bundle\SwooleBundle::class => ['all' => true],
    ];
  5. 运行Swoole HTTP服务器

    bin/console swoole:server:run
  6. 输入https://:9501

  7. 现在您可以根据需要配置包

功能

  • 内置API服务器

    Swoole Bundle API服务器允许实时管理Swoole HTTP服务器。

    • 重新加载工作进程
    • 关闭服务器
    • 访问指标和设置
  • 改进的静态文件服务

    Swoole HTTP服务器提供默认的静态文件处理器,但它不支持许多Content-Types。为了克服这个问题,有一个可配置的先进静态文件服务器。在开发环境中默认启用静态文件服务。静态文件目录默认为%kernel.project_dir%/public。要配置自定义MIME类型,请参阅配置参考(键swoole.http_server.static.mime_types)。

  • Symfony Messenger集成

    自版本:0.6起可用

    Swoole Server Task Transport已集成到此包中,以允许轻松执行异步操作。此功能的文档可在此处找到。

  • 开发用热模块重新加载(HMR)ALPHA

    由于Swoole HTTP服务器在事件循环中运行且不请求之间刷新内存,为了保持DX与普通服务器相同,此包使用代码替换技术,使用inotify PHP扩展允许持续开发。默认启用(当找到扩展时)且无需额外配置。您可以在包配置中将其关闭。

    备注:此功能目前仅在Linux主机机器上工作。它可能无法与Docker一起使用,并且它可能仅在配置:swoole.http_server.running_mode: process(默认)下工作。

需求

当前版本

  • PHP版本>= 7.4
  • Swoole PHP扩展>= 4.5.10
  • Symfony >= 4.4.0

未来版本

  • PHP版本>= 8.0
  • Swoole PHP扩展>= 4.6
  • Symfony >= 5.0

启用特定功能的其他需求

  • Inotify PHP扩展 ^2.0.0 以使用热模块重新加载(HMR)
    • 当使用PHP 8时,需要inotify版本^3.0.0

Swoole

包需要Swoole PHP扩展版本4.5.10或更高版本。仅针对最新版本提供活动错误修复。

版本检查

要检查您的安装版本,您可以运行以下命令

php -r "echo swoole_version() . \PHP_EOL;"

# 4.4.7

安装

官方GitHub仓库swoole/swoole-src包含全面的安装指南。推荐的方法是从源码安装。