tbn / swoole-bundle
Swoole Symfony Bundle
Requires
- php: ^7.4|^8.0
- ext-json: *
- ext-openswoole: ^4.7.1|^22.0.0
- beberlei/assert: ^3.0
- symfony/config: ^4.4.0|^5.0|^6.0|^7.0
- symfony/console: ^4.4.0|^5.0|^6.0|^7.0
- symfony/dependency-injection: ^4.4.0|^5.0|^6.0|^7.0
- symfony/http-foundation: ^4.4.0|^5.0|^6.0|^7.0
- symfony/http-kernel: ^4.4.0|^5.0|^6.0|^7.0
- symfony/process: ^4.4.0|^5.0|^6.0|^7.0
Requires (Dev)
- doctrine/annotations: ^1.6
- doctrine/orm: ^2.6.3
- friendsofphp/php-cs-fixer: ^2.19.0
- jangregor/phpstan-prophecy: ^0.8.0
- phpspec/prophecy-phpunit: ^2.0
- phpstan/extension-installer: ^1.0.2
- phpstan/phpstan: ^0.12.28
- phpstan/phpstan-beberlei-assert: ^0.12.2
- phpstan/phpstan-doctrine: ^0.12.9
- phpstan/phpstan-phpunit: ^0.12.6
- phpunit/php-code-coverage: ^9.1.0
- phpunit/phpcov: ^8.1.0
- phpunit/phpunit: ^9.1.3
- swoole/ide-helper: ^4.5.10
- symfony/debug-pack: ^1.0
- symfony/error-handler: ^4.4.0|^5.0|^6.0|^7.0
- symfony/framework-bundle: ^4.4.0|^5.0|^6.0|^7.0
- symfony/messenger: ^4.4.0|^5.0|^6.0|^7.0
- symfony/monolog-bridge: ^4.4.0|^5.0|^6.0|^7.0
- symfony/monolog-bundle: ^3.3
- symfony/profiler-pack: ^1.0
- symfony/twig-bundle: ^4.4.0|^5.0|^6.0|^7.0
- symfony/var-dumper: ^4.4.0|^5.0|^6.0|^7.0
- symfony/yaml: ^4.4.0|^5.0|^6.0|^7.0
- upscale/swoole-blackfire: ^3.0
Suggests
- ext-inotify: To enable HMR
- doctrine/orm: For using Entity Manager Handler
- pixelfederation/doctrine-resettable-em-bundle: To be able to recover Doctrine Entity Managers from errors
- symfony/error-handler: To use Symfony Error Handler
- symfony/messenger: For using Symfony Messenger Swoole Task Transport.
- upscale/swoole-blackfire: To enable Blackfire profiling
- dev-master
- v0.13.0
- v0.12.0
- v0.11.0
- v0.10.0
- v0.9.0
- v0.8.3
- v0.8.2
- v0.8.1
- v0.8.0
- v0.7.9
- v0.7.8
- v0.7.7
- v0.7.6
- v0.7.5
- v0.7.4
- v0.7.3
- v0.7.2
- v0.7.1
- v0.7.0
- v0.6.2
- v0.6.1
- v0.6.0
- v0.5.3
- v0.5.2
- v0.5.1
- v0.5.0
- v0.4.4
- v0.4.3
- v0.4.2
- v0.4.1
- v0.4.0
- v0.3.0
- v0.2.0
- dev-swoole-telemetry
- dev-sf7
- dev-symfony6
- dev-openswoole
- dev-dependabot/composer/develop/friendsofphp/php-cs-fixer-3.0.1
- dev-dependabot/composer/develop/phpstan/phpstan-0.12.94
- dev-dependabot/composer/develop/symfony/http-foundation-5.3.6
- dev-dependabot/composer/develop/symfony/console-5.3.6
- dev-dependabot/composer/develop/symfony/http-kernel-5.2.14
- dev-dependabot/composer/develop/symfony/dependency-injection-5.2.12
- dev-dependabot/composer/develop/symfony/config-5.3.4
- dev-dependabot/composer/develop/swoole/ide-helper-4.7.0
- dev-dependabot/composer/develop/phpstan/phpstan-phpunit-0.12.21
- dev-dependabot/composer/develop/doctrine/annotations-1.13.1
- dev-feat/signal-handling
- dev-dependabot/add-v2-config-file
- dev-feat/fsnotify-hmr
- dev-feat/dynamic-listeners
- dev-develop / 0.8.x-dev
This package is auto-updated.
Last update: 2024-09-16 13:56:12 UTC
README
使用 Swoole(https://www.swoole.co.uk/)与 Symfony 集成以加速您的应用程序。
构建矩阵
目录
快速入门指南
-
确保您已安装合适的 Swoole PHP 扩展并满足其他 要求。
-
(可选) 创建一个新的 symfony 项目
composer create-project symfony/skeleton project cd ./project
-
在您的 symfony 应用程序中安装包
composer require k911/swoole-bundle
-
编辑
config/bundles.php
return [ // ...other bundles K911\Swoole\Bridge\Symfony\Bundle\SwooleBundle::class => ['all' => true], ];
-
运行 Swoole HTTP 服务器
bin/console swoole:server:run
-
您现在可以根据需要配置包
功能
-
内置 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
- 当使用 PHP 8 时,需要 inotify 版本
Swoole
包需要 Swoole PHP 扩展 版本 4.5.10
或更高版本。仅针对最新版本提供活动错误修复。
版本检查
要检查您的安装版本,您可以使用以下命令
php -r "echo swoole_version() . \PHP_EOL;" # 4.4.7
安装
官方GitHub仓库 swoole/swoole-src 包含了全面的安装指南。推荐的安装方法是 从源码安装。