explaingit

easy-swoole/easyswoole

★ 4,766PHPAudience · developerComplexity · 4/5LicenseSetup · hard

TLDR

A high-performance PHP framework for building fast API servers that can handle thousands of simultaneous users. It keeps PHP running continuously as a persistent process instead of restarting on every request, enabling 8,000+ requests per second on basic hardware.

Mindmap

mindmap
  root((EasySwoole))
  Connection Types
    HTTP
    TCP and UDP
    WebSocket
  Performance
    Persistent processes
    Async processing
    Coroutines
    8600 reqs per sec
  Architecture
    Multiple processes
    Task queue
    CPU affinity
  Documentation
    Chinese README
    Official website
    Gitbook format
  Community
    QQ group
    GitHub issues
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Build a PHP API server that handles thousands of concurrent users without expensive hardware

USE CASE 2

Add real-time features like chat or live updates to a PHP application using WebSocket

USE CASE 3

Process background tasks asynchronously so API responses stay fast

USE CASE 4

Replace a slow traditional PHP setup where each request restarts the entire application

Tech stack

PHPSwoolecoroutinesWebSocketTCP/UDP

Getting it running

Difficulty · hard Time to first run · 1h+

Requires the Swoole PHP extension installed on the server. Documentation is primarily in Chinese. Best suited for Linux servers. Not a drop-in replacement for traditional PHP frameworks.

Apache 2.0 license, free to use and modify, even in commercial products, as long as you include the license notice.

In plain English

EasySwoole is a PHP framework designed for building high-performance API servers. It is built on top of Swoole, a lower-level PHP extension that allows PHP applications to run as persistent, always-on processes rather than restarting from scratch on every web request. That persistent mode removes a common bottleneck in traditional PHP applications and allows the server to handle many more simultaneous connections. The framework supports HTTP, TCP, UDP, and WebSocket connections in the same application. It is aimed at developers building backend services or APIs where speed and the ability to handle large numbers of concurrent users matter. The README, written in Chinese, highlights support for asynchronous processing, coroutines, multiple processes, and multiple threads, as well as CPU affinity and a task queue system. A benchmark result included in the README shows the framework handling around 8,600 requests per second for a simple response on a single-core server with 1GB of RAM running on a basic cloud instance. The test used 100 concurrent connections and 50,000 total requests, with 99% of responses completing in under 13 milliseconds and no failed requests. Documentation is available at the project's official website and is maintained in a separate GitHub repository using the Gitbook format. A QQ group number is listed for community support, which is common for Chinese open-source projects. The README is brief and written primarily in Chinese.

Copy-paste prompts

Prompt 1
I want to build a high-performance REST API in PHP using EasySwoole. Show me the basic project structure and how to define a simple HTTP endpoint.
Prompt 2
How do I set up a WebSocket server with EasySwoole that can handle real-time messages from thousands of connected clients?
Prompt 3
Explain how EasySwoole's task queue works and show me how to offload a slow operation like sending an email to run in the background.
Prompt 4
What is the difference between running PHP with EasySwoole versus a traditional Apache or nginx PHP setup, and when should I choose EasySwoole?
Open on GitHub → Explain another repo

← easy-swoole on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.