swoole/swoole-src
Swoole Src
Swoole is a coroutine-based concurrency library and IO framework for PHP. It provides a system for building high-performance network servers and applications by bringing asynchronous, event-driven, and coroutine-based concurrency to the PHP runtime.
The project distinguishes itself by implementing user-space coroutine scheduling and non-blocking IO interception, which transforms standard blocking network and file operations into asynchronous actions. It further enables high-speed data exchange across multiple PHP processes through shared memory management and specialized data structures.
The framework covers a broad surface of networking and storage capabilities, including asynchronous network servers and clients, wire protocol support, and non-blocking database and file system drivers. It also includes observability tools for inspecting coroutine states, reactor metrics, and timer schedules.
A containerized debug environment is available for analyzing runtime crashes and memory errors using address sanitizers.
Features
- Stack-Based Coroutine Schedulers - Implements a user-space coroutine scheduler that multiplexes lightweight threads onto OS threads using dynamic stacks.
- PHP - Provides a coroutine-based IO framework that transforms blocking network and file operations into non-blocking actions.
- Asynchronous Database Drivers - Ships a collection of asynchronous database drivers for high-concurrency read and write operations without stalling execution.
- Shared Memory Data Exchange - Provides high-speed shared memory data structures like tables and ring buffers for inter-process communication.
- User-Space Concurrency - Manages user-space lightweight threads that cooperatively switch contexts to handle concurrent operations.
- Asynchronous Network Clients - Provides high-performance asynchronous network clients for diverse protocols to keep applications responsive.
- Server Frameworks - Enables the creation of high-performance asynchronous servers that support multiple protocols on a single event loop.
- Reactor Patterns - Implements an event-driven reactor loop to dispatch high-volume network events to registered handlers.
- Non-Blocking Suspension Points - Intercepts blocking system calls to yield control to the scheduler, keeping the execution thread active.
- Concurrency Libraries - Brings asynchronous, event-driven, and coroutine-based concurrency primitives to the PHP runtime.
- Coroutine Orchestrators - Provides a coroutine orchestrator to manage the suspension and resumption of lightweight threads for asynchronous IO.
- Task Schedulers - Executes tasks as lightweight threads using a portable task-dispatching implementation for asynchronous performance.
- PHP Extension Bindings - Binds high-performance C++ networking and concurrency primitives directly to the PHP runtime.
- High-Performance Server - Provides a high-performance runtime optimized for low-latency network I/O and high-throughput request handling in PHP.
- Non-blocking IO Architectures - Transforms standard blocking network and file calls into asynchronous operations using non-blocking IO architectures.
- Shared Memory Management - Provides high-speed shared memory tables and ring buffers for state synchronization across multiple PHP processes.
- Event-Driven I/O - Manages high volumes of concurrent network connections using platform-specific event notification systems.
- Network Protocol Implementations - Implements support for standard network protocols used in web, messaging, and proxy services.
- Real-time Communication - Implements protocols and patterns for maintaining persistent connections and low-latency data streaming.
- Socket Networking - Provides low-level asynchronous socket polling to monitor network events and return responses upon trigger.
- Asynchronous File System Drivers - Performs file operations without blocking the main execution thread using high-performance system interfaces.
- Channel-Based Concurrency - Provides communication mechanisms for safe data exchange and synchronization between concurrent coroutines.
- Timer Schedulers - Provides interfaces for scheduling asynchronous callbacks using non-blocking timers and intervals.
- Asynchronous File I/O - Provides high-performance asynchronous file system interfaces that prevent disk operations from blocking the main execution thread.
- Worker Pool Models - Uses a worker-pool model to distribute incoming network requests from a main reactor to background processes.
- Worker-Task Dispatch Models - Runs network applications using worker and task-worker patterns for asynchronous request dispatch.
- Inter-Process Communication - Enables bidirectional data exchange between concurrent coroutines using thread-safe communication channels.
- Event and Async Programming - Provides a high-performance concurrent networking framework.
