Event-driven, non-blocking I/O with PHP.
The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:
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 and interaction with processes. Third-party libraries can use these components to create async network clients/servers and more.
ReactPHP is production ready and battle-tested with millions of installations from all kinds of projects around the world. Its event-driven architecture makes it a perfect fit for efficient network servers and clients handling hundreds or thousands of concurrent connections, long-running applications and many other forms of cooperative multitasking with non-blocking I/O operations. What makes ReactPHP special is its vivid ecosystem with hundreds of third-party libraries allowing you to integrate with many existing systems, such as common network services, database systems and other third-party APIs.
ReactPHP is non-blocking by default. Use workers for blocking I/O. 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).
This repository you're currently looking at is mostly used as a meta repository to discuss and plan all things @ReactPHP. See the individual components linked below for more details about each component, its documentation and source code.
EventLoopReactPHP's core reactor event-loop.Read the documentation
StreamEvent-driven readable and writable streams for non-blocking I/O in ReactPHP.Read the documentation
PromisePromises/A implementation for PHP.Read the documentation
SocketAsync, streaming plaintext TCP/IP and secure TLS socket server and client connections for ReactPHP.Read the documentation
DatagramEvent-driven UDP client and server sockets for ReactPHP.Read the documentation
HTTPEvent-driven, streaming plaintext HTTP and secure HTTPS server for ReactPHP.Read the documentation
HTTPClientEvent-driven, streaming HTTP client for ReactPHP.Read the documentation
DNSAsync DNS resolver for ReactPHP.Read the documentation
CacheAsync caching for ReactPHP.Read the documentation
ChildProcessLibrary for executing child processes.Read the documentation
PromiseTimerTrivial timeout implementation for ReactPHP's Promise lib.Read the documentation
PromiseStreamThe missing link between Promise-land and Stream-land, built on top of ReactPHP.Read the documentation
ThruwayPHP Client and Router Library for Autobahn and WAMP (Web Application Messaging Protocol) for Real-Time Application Messagingvoryx/Thruway
PPM - PHP Process ManagerPPM is a process manager, supercharger and load balancer for modern PHP applications.php-pm/php-pm
php-ar-drone🚁 Port of node-ar-drone which allows user to control a Parrot AR Drone over PHPjolicode/php-ar-drone
RatchetAsynchronous WebSocket serverratchetphp/Ratchet
Predis\AsyncAsynchronous PHP client library for Redis built on top of ReactPHPnrk/predis-async
clue/redis-serverA Redis server implementation in pure PHPclue/redis-server
Sergey ZhukA series of articles covering ReactPHP: from the basics to the real application examples.sergeyzhuk.me
Cees-Jan KiewietBlog series about several ReactPHP components and how they work.blog.wyrihaximus.net
Loïc FaugeronSuper Speed Symfony - ReactPHP.gnugat.github.io
Marc J. SchmidtBring High Performance Into Your PHP App (with ReactPHP).marcjschmidt.de
Marc MoreraWhen ReactPHP meet Symfonymedium.com/@apisearch
Christian LückPushing the limits with ReactPHP
Jeremy MikolaAsync PHP With React
Igor WiedlerEvent-driven PHP
ReactPHP consists of a set 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:
# recommended install: pick required components $ composer require react/event-loop react/http
As an alternative, we also provide a meta package that will install all stable components at once. Installing this is only recommended for quick prototyping, as the list of stable components may change over time. This meta package can be installed like this:
# quick protoyping only: install all stable components $ composer require react/react:^1.1
For more details, check out ReactPHP's homepage for quickstart examples and usage details.
See also the combined changelog for all ReactPHP componentsfor details about version upgrades.
Do you have a question and need help with ReactPHP? Don't worry, we're here to help!
As a first step, check the elaborate documentation that comes with each component (see links to individual documentation for each component above). If you find your question is not answered within the documentation, there's a fair chance that it may be relevant to more people. Please do not hesitate to file your question as an issue in the relevant component so others can also participate.
You can also check out our official Gitter chat room. Most of the people involved in this project are available in this chat room, so many questions get answered in a few minutes to some hours. We also use this chat room to announce all new releases and ongoing development efforts, so consider staying in this chat room for a little longer.
Also follow @reactphp on Twitter for updates. We use this mostly for noteworthy, bigger updates and to keep the community updated about ongoing development efforts. You can always use the
hashtag if you have anything to share!
We're a very open project and we prefer public communication whenever possible, so that more people can participate and help getting the best solutions available. At the same time, we realize that some things are better addressed in private. Whether you just want to say thank you, want to report a security issue or want to help sponsor a certain feature development, you can reach out to the core team in private by sending an email to
. Please keep in mind that we're a small team of volunteers and do our best to support anybody reaching out.
Do you want to support ReactPHP? Awesome! Let's start with letting the the world know why you think ReactPHP is awesome and try to help others getting on board! Send a tweet, write a blog post, give a talk at your local user group or conference or even write a book. There are many ways you can help. You can always reach out to us in private and help others in our support channels. Thank you!
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
The test suite also contains a number of functional integration tests that rely on a stable internet connection. Due to the vast number of integration tests, these are skipped by default on Travis CI. If you also do not want to run these, they can simply be skipped like this:
$ php vendor/bin/phpunit --exclude-group internet
MIT, see LICENSE.