Nuclear Reactor written in PHP.
Event-driven, non-blocking I/O with PHP.
ReactPHP is a low-level library for event-driven programming in PHP. At its core is an event loop, on top of which it provides low-level utilities, such as: Streams abstraction, async dns resolver, network client/server, http client/server, interaction with processes. Third-party libraries can use these components to create async network clients/servers and more.
The event loop is based on the reactor pattern (hence the name) and strongly inspired by libraries such as EventMachine (Ruby), Twisted (Python) and Node.js (V8).
- Usable with a bare minimum of PHP extensions, add more extensions to get better performance.
- Provide a standalone event-loop component that can be re-used by other libraries.
- Decouple parts so they can be replaced by alternate implementations.
ReactPHP is non-blocking by default. Use workers for blocking I/O.
EventLoop ReactPHP's core reactor event-loop. Read the documentation
Stream Event-driven readable and writable streams for non-blocking I/O in ReactPHP. Read the documentation
Promise Promises/A implementation for PHP. Read the documentation
Socket Async, streaming plaintext TCP/IP and secure TLS socket server and client connections for ReactPHP. Read the documentation
Datagram Event-driven UDP client and server sockets for ReactPHP. Read the documentation
HTTP Event-driven, streaming plaintext HTTP and secure HTTPS server for ReactPHP. Read the documentation
HTTPClient Event-driven, streaming HTTP client for ReactPHP. Read the documentation
DNS Async DNS resolver for ReactPHP. Read the documentation
Cache Async caching for ReactPHP. Read the documentation
ChildProcess Library for executing child processes. Read the documentation
PromiseTimer Trivial timeout implementation for ReactPHP's Promise lib. Read the documentation
PromiseStream The missing link between Promise-land and Stream-land, built on top of ReactPHP. Read the documentation
ReactPHP consists of individual components. This means that instead of installing something like a "ReactPHP framework", you actually pick only the components that you need.
For example, this may look something like this:
$ composer require react/event-loop react/http
For more details, check out ReactPHP's homepage for quickstart examples and usage details.
Superficial documentation can be found in the README files of the individual
Check out #reactphp on irc.freenode.net. Also follow @reactphp on twitter.
To run the test suite, you first need to clone this repo and then install all dependencies through Composer:
$ composer install
To run the test suite, go to the project root and run:
$ php vendor/bin/phpunit
MIT, see LICENSE.