README

通过 Swoole（https://www.swoole.co.uk/）与 Symfony 集成，加快您的应用程序。

目录

• Swoole Bundle
  • 快速入门指南
  • 特性
  • 需求
    • 当前版本
    • 未来版本
    • Swoole
      • 版本检查
      • 安装

快速入门指南

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

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

   composer create-project symfony/skeleton project
   
   cd ./project

3. 在您的 symfony 应用程序中安装 bundle

   composer require vasyaxy/symfony-swoole-bundle

4. 编辑 config/bundles.php

   return [
       // ...other bundles
       vasyaxy\Swoole\Bridge\Symfony\Bundle\SwooleBundle::class => ['all' => true],
   ];

5. 运行 Swoole HTTP 服务器

   bin/console swoole:server:run

6. 访问 https://:9501

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

特性

• 内置 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 服务器任务传输已集成到此 bundle 中，以允许轻松执行异步操作。此功能的文档可在 此处 查看。

• 开发中的热模块重载 (HMR) ALPHA

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

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

需求

当前版本

• PHP 版本 >= 8.2
• Swoole PHP 扩展 >= 5.0.1
• Symfony >= 6.2

启用特定功能所需的其他需求

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

Swoole

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

版本检查

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

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

# 5.0.1

安装

官方 GitHub 仓库 swoole/swoole-src 包含完整的安装指南。建议从源代码安装。