PHPackages                             pixelfederation/swoole-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP &amp; Networking](/categories/http)
4. /
5. pixelfederation/swoole-bundle

ActiveLibrary[HTTP &amp; Networking](/categories/http)

pixelfederation/swoole-bundle
=============================

Swoole Symfony Bundle

v0.13.2(2y ago)3311.4k10[1 issues](https://github.com/pixelfederation/swoole-bundle/issues)[3 PRs](https://github.com/pixelfederation/swoole-bundle/pulls)MITPHPPHP ^7.4|^8.0

Since Oct 7Pushed 2y ago5 watchersCompare

[ Source](https://github.com/pixelfederation/swoole-bundle)[ Packagist](https://packagist.org/packages/pixelfederation/swoole-bundle)[ Docs](https://github.com/k911/swoole-bundle)[ RSS](/packages/pixelfederation-swoole-bundle/feed)WikiDiscussions develop Synced 2mo ago

READMEChangelog (6)Dependencies (36)Versions (50)Used By (0)

Swoole Bundle
=============

[](#swoole-bundle)

[![Maintainability](https://camo.githubusercontent.com/19dc0eaded76e822ec9b6d648b931d947408caa3e1025b45611e9a52dd8d689c/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f31643733613231343632326262613736393137312f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/pixelfederation/swoole-bundle/maintainability)[![Test Coverage](https://camo.githubusercontent.com/f6b6abc39a2b8ccc9e1781e9fc204fc49fbd8577af21f648f267f54b9db7eef0/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f31643733613231343632326262613736393137312f746573745f636f766572616765)](https://codeclimate.com/github/pixelfederation/swoole-bundle/test_coverage)[![Open Source Love](https://camo.githubusercontent.com/a8a6219cf0313b681948382bcbcc27a34ae00572d463437bd92ebb1df58647c9/68747470733a2f2f6261646765732e66726170736f66742e636f6d2f6f732f76312f6f70656e2d736f757263652e7376673f763d313033)](https://github.com/ellerbrock/open-source-badges/)[![MIT Licence](https://camo.githubusercontent.com/fabb40ab22588a0746bb0916ed92739171bde7fb31f281c627aa588bcba62cc2/68747470733a2f2f6261646765732e66726170736f66742e636f6d2f6f732f6d69742f6d69742e7376673f763d313033)](https://opensource.org/licenses/mit-license.php)

Symfony integration with [Open Swoole](https://openswoole.com/) to speed up your applications.

Sponsored by:[Blackfire.io](https://blackfire.io/)[![Blackfire.io](docs/img/blackfire-io.png)](https://blackfire.io/)[Travis CI](https://travis-ci.com/)[![Travis CI](https://camo.githubusercontent.com/686c31a345b30689cabbf14926f217bb56381384065710ae38e3629f608d2755/68747470733a2f2f7777772e7472617669732d63692e636f6d2f77702d636f6e74656e742f75706c6f6164732f323032322f30392f4c6f676f2e706e67)](https://travis-ci.com/)---

Build Matrix
------------

[](#build-matrix)

CI JobBranch [`master`](https://github.com/pixelfederation/swoole-bundle/tree/master)Branch [`develop`](https://github.com/pixelfederation/swoole-bundle/tree/develop)Circle[![CircleCI](https://camo.githubusercontent.com/5a9997c38076cfd98d8cb98b880a985ed211159b307e67ca1aad29e0544e89bb/68747470733a2f2f636972636c6563692e636f6d2f67682f706978656c66656465726174696f6e2f73776f6f6c652d62756e646c652f747265652f6d61737465722e7376673f7374796c653d737667)](https://circleci.com/gh/pixelfederation/swoole-bundle/tree/master)[![CircleCI](https://camo.githubusercontent.com/7dbc3342ed49867524bf16b6f1d42036691ddd92fd7ab9bb079f1e4f2b06d911/68747470733a2f2f636972636c6563692e636f6d2f67682f706978656c66656465726174696f6e2f73776f6f6c652d62756e646c652f747265652f646576656c6f702e7376673f7374796c653d737667)](https://circleci.com/gh/pixelfederation/swoole-bundle/tree/develop)CodeCov[![codecov](https://camo.githubusercontent.com/9d9d789dad7f1f9c7f1af42059cdd9a746223b1cc84fe4c403ec921b44a11b36/68747470733a2f2f636f6465636f762e696f2f67682f706978656c66656465726174696f6e2f73776f6f6c652d62756e646c652f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/pixelfederation/swoole-bundle)[![codecov](https://camo.githubusercontent.com/c3998758552ff1961b79897fbbf90c34df4f5de1eb4eaa175ec8a357694c6f23/68747470733a2f2f636f6465636f762e696f2f67682f706978656c66656465726174696f6e2f73776f6f6c652d62756e646c652f6272616e63682f646576656c6f702f67726170682f62616467652e737667)](https://codecov.io/gh/pixelfederation/swoole-bundle)Travis[![Build Status](https://camo.githubusercontent.com/0918acb3d03d71fdbe130cc6f28249aa6fd3242e1097996f5ee7eeb01ca9672e/68747470733a2f2f6170702e7472617669732d63692e636f6d2f706978656c66656465726174696f6e2f73776f6f6c652d62756e646c652e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/pixelfederation/swoole-bundle)[![Build Status](https://camo.githubusercontent.com/37d65228a63d426ac151f7e52085f60cbf7e651551ed3093ae3fa305a367dea6/68747470733a2f2f6170702e7472617669732d63692e636f6d2f706978656c66656465726174696f6e2f73776f6f6c652d62756e646c652e7376673f6272616e63683d646576656c6f70)](https://travis-ci.com/pixelfederation/swoole-bundle)Table of Contents
-----------------

[](#table-of-contents)

- [Swoole Bundle](#swoole-bundle)
    - [Build Matrix](#build-matrix)
    - [Table of Contents](#table-of-contents)
    - [Quick start guide](#quick-start-guide)
    - [Features](#features)
    - [Requirements](#requirements)
        - [Current version](#current-version)
        - [Future versions](#future-versions)
        - [Open Swoole](#open-swoole)
            - [Version check](#version-check)
            - [Installation](#installation)

Quick start guide
-----------------

[](#quick-start-guide)

1. Make sure you have installed proper Open Swoole PHP Extension and pass other [requirements](#requirements).
2. (optional) Create a new symfony project

    ```
    composer create-project symfony/skeleton project

    cd ./project
    ```
3. Install bundle in your Symfony application

    ```
    composer require pixelfederation/swoole-bundle
    ```
4. Edit `config/bundles.php`

    ```
    return [
        // ...other bundles
        K911\Swoole\Bridge\Symfony\Bundle\SwooleBundle::class => ['all' => true],
    ];
    ```
5. Run Swoole HTTP Server

    ```
    bin/console swoole:server:run
    ```
6. Enter
7. You can now configure bundle according to your needs

Features
--------

[](#features)

- Built-in API Server

    Swoole Bundle API Server allows managing Swoole HTTP Server in real-time.

    - Reload worker processes
    - Shutdown server
    - Access metrics and settings
- Improved static files serving

    Swoole HTTP Server provides a default static files handler, but it lacks supporting many `Content-Types`. To overcome this issue, there is a configurable Advanced Static Files Server. Static files serving remains enabled by default in the development environment. Static files directory defaults to `%kernel.project_dir%/public`. To configure your custom mime types check [configuration reference](docs/configuration-reference.md) (key `swoole.http_server.static.mime_types`).
- Symfony Messenger integration

    *Available since version: `0.6`*

    Swoole Server Task Transport has been integrated into this bundle to allow easy execution of asynchronous actions. Documentation of this feature is available [here](docs/swoole-task-symfony-messenger-transport.md).
- Hot Module Reload (HMR) for development **ALPHA**

    Since Swoole HTTP Server runs in Event Loop and does not flush memory between requests, to keep DX equal with normal servers, this bundle uses code replacement technique, using `inotify` PHP Extension to allow continuous development. It is enabled by default (when the extension is found) and requires no additional configuration. You can turn it off in bundle configuration.

    *Remarks: This feature currently works only on a Linux host machine. It probably won't work with Docker, and it is possible that it works only with configuration: `swoole.http_server.running_mode: process` (default).*
- Access logs, (disabled by default) logs are configurable is a same way as apache mod log. Documentation of this feature is available [here](docs/swoole-access-logs.md).

Requirements
------------

[](#requirements)

### Current version

[](#current-version)

- PHP version `>= 8.0`
- Open Swoole PHP Extension `>= 4.12.1`
- Symfony `>= 5.4.0`

### Future versions

[](#future-versions)

- PHP version `>= 8.2`
- Swoole PHP Extension `>= v22.0.0`
- Symfony `>= 6.1`

Additional requirements to enable specific features:

- [Inotify PHP Extension](https://pecl.php.net/package/inotify) `^2.0.0` to use Hot Module Reload (HMR)
    - When using PHP 8, inotify version `^3.0.0` is required

### Open Swoole

[](#open-swoole)

Bundle requires [Open Swoole PHP Extension](https://github.com/openswoole/swoole-src) version `4.10.0` or higher. Active bug fixes are provided only for the latest version.

#### Version check

[](#version-check)

To check your installed version you can run the following command:

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

# 4.10.0
```

#### Installation

[](#installation)

Official GitHub repository [openswoole/swoole-src](https://github.com/openswoole/swoole-src#installation) contains comprehensive installation guide. The recommended approach is to install it [from source](https://github.com/openswoole/swoole-src#2-compile-from-source).

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity32

Limited adoption so far

Community23

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~52 days

Recently: every ~140 days

Total

36

Last Release

948d ago

PHP version history (4 changes)v0.2.0PHP ^7.2

v0.6.1PHP ^7.3

v0.8.3PHP ^7.3|^8.0

v0.9.0PHP ^7.4|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/2f41a9b6b3fcc495a546791e3993b29832b7a4b08f34ad094a1131e2e8784d01?d=identicon)[pixelfederation](/maintainers/pixelfederation)

---

Top Contributors

[![k911](https://avatars.githubusercontent.com/u/10072889?v=4)](https://github.com/k911 "k911 (257 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (185 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (99 commits)")[![Rastusik](https://avatars.githubusercontent.com/u/1735097?v=4)](https://github.com/Rastusik "Rastusik (8 commits)")[![supersmile2009](https://avatars.githubusercontent.com/u/25199815?v=4)](https://github.com/supersmile2009 "supersmile2009 (7 commits)")[![swoole-bundle-bot](https://avatars.githubusercontent.com/u/64752855?v=4)](https://github.com/swoole-bundle-bot "swoole-bundle-bot (6 commits)")[![pf-releaser-bot](https://avatars.githubusercontent.com/u/110130338?v=4)](https://github.com/pf-releaser-bot "pf-releaser-bot (5 commits)")[![fjogeleit](https://avatars.githubusercontent.com/u/16627596?v=4)](https://github.com/fjogeleit "fjogeleit (4 commits)")[![jderusse](https://avatars.githubusercontent.com/u/578547?v=4)](https://github.com/jderusse "jderusse (2 commits)")[![luca-nardelli](https://avatars.githubusercontent.com/u/6215162?v=4)](https://github.com/luca-nardelli "luca-nardelli (2 commits)")[![Wirone](https://avatars.githubusercontent.com/u/600668?v=4)](https://github.com/Wirone "Wirone (1 commits)")[![CoderChang65535](https://avatars.githubusercontent.com/u/19420270?v=4)](https://github.com/CoderChang65535 "CoderChang65535 (1 commits)")[![enumag](https://avatars.githubusercontent.com/u/539462?v=4)](https://github.com/enumag "enumag (1 commits)")[![mab05k](https://avatars.githubusercontent.com/u/11943457?v=4)](https://github.com/mab05k "mab05k (1 commits)")[![ChadSikorra](https://avatars.githubusercontent.com/u/388229?v=4)](https://github.com/ChadSikorra "ChadSikorra (1 commits)")

---

Tags

httpphpasyncbundleserverswoole

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/pixelfederation-swoole-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/pixelfederation-swoole-bundle/health.svg)](https://phpackages.com/packages/pixelfederation-swoole-bundle)
```

###  Alternatives

[swoole-bundle/swoole-bundle

Open/Swoole Symfony Bundle

6650.4k](/packages/swoole-bundle-swoole-bundle)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M650](/packages/sylius-sylius)[nelmio/api-doc-bundle

Generates documentation for your REST API from attributes

2.3k63.6M232](/packages/nelmio-api-doc-bundle)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
