A non-blocking HTTP/Websocket server
Aerys is a non-blocking HTTP/1.1 and HTTP/2 application, WebSocket and static file server written in PHP based on Amp.
This repository is deprecated in favor of
It still exists to keep the documentation and also Packagist working as before.
composer require amphp/aerys
php bin/aerys -c demo.php
Simply execute the
aerys binary (with PHP 7) to start a server listening on
the default configuration file (packaged with the repository).
-d switch to see some debug output like the routes called etc.:
php bin/aerys -d -c demo.php
-c, --config switches to define the config file:
php bin/aerys -c /path/to/my/config.php
-h, --help switches for more instructions.
To start a static file server simply pass a root handler as part of your config file.
return (new Aerys\Host) ->expose("*", 1337) ->use(Aerys\root(__DIR__ . "/public"));
If you discover any security related issues, please email
email@example.com instead of using the issue tracker.
The MIT License (MIT). Please see LICENSE for more information.