Swoole

Official Docker image for Swoole, an event-driven networking engine and coroutine runtime for PHP.

  • Development
  • Tools & Utilities
Official Docker image for Swoole, an event-driven networking engine and coroutine runtime for PHP. It provides an event loop, coroutine scheduler, and built-in servers and clients for building persistent network services and concurrent I/O applications, letting you handle many connections without a separate PHP process per request — a good fit for HTTP APIs, WebSocket apps, and TCP/UDP gateways.

Platform availability

Available on 0 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

76/100 Good

Maintained
100last commit 16 days ago
Popular
8618,932 GitHub stars
Easy to install
250 install platforms, install notes, Docker image
Light to run
No data
Security check
66no serious findings, tests, OpenSSF Scorecard 3.8/10

Based on 4 of 5 factors.

GitHub stars
18,932
Open issues
15
Last commit
2026-11-05
Latest release
v6.2.4
License
Apache-2.0
Activity
rising

Checked 16 days ago - source: GitHub (swoole/swoole-src)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install the Swoole extension into PHP first Use PECL (the PHP extension installer) to install Swoole into your PHP setup, and enable extras like OpenSSL or MySQL if your app needs them. Without the extension, PHP won't recognize Swoole classes, so your app will fail at startup. source
  • Start your server by running a PHP file Run your Swoole server script with php /path/to/your_file.php from a terminal. Swoole isn't started by a built-in service name; if you skip this, nothing is listening for web requests. source
  • Keep the event loop alive with Event::wait If your code uses Swoole events or timers, call Swoole\Event::wait() after setting them up. Without it, the PHP process ends immediately, so timers and network events never run. source
  • Choosing a production version For production, pick a released version (not the master development branch) and confirm its PHP compatibility and maintenance status. source

Fetched 42 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I install Swoole into PHP so the classes are recognized?

Install the Swoole extension using PECL and enable extras such as OpenSSL or MySQL if your app needs them. Without the extension, PHP will not recognize Swoole classes and the app will fail at startup.

How do I start a Swoole server?

Run your Swoole server script with php /path/to/your_file.php. Swoole is not started by a built-in service name, so if you skip this nothing is listening for web requests.

How do I keep Swoole events or timers running?

Call Swoole\Event::wait() after setting up events or timers. Without it, the PHP process ends immediately and the timers or network events never run.

What should I do if Swoole cannot bind to an IP or port?

Another process may be using the same IP and port. Kill that process or change the hostname and port number.

What Docker setup issue has been reported with Swoole and Laravel?

A Laravel 9 app using Swoole inside Docker can suffer a significant performance drop. The report specifically noted the issue on custom Docker networks.

Answers sourced from github.com, github.com, github.com, openswoole.com, www.reddit.com

Community

Collected 48 days ago - public community threads