A non-blocking HTTP application, WebSocket and file server for PHP based on Amp.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.



Build Status License

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 amphp/http-server. It still exists to keep the documentation and also Packagist working as before.


composer require amphp/aerys


Running a Server

php bin/aerys -c demo.php

Simply execute the aerys binary (with PHP 7) to start a server listening on http://localhost/ using the default configuration file (packaged with the repository).

Add a -d switch to see some debug output like the routes called etc.:

php bin/aerys -d -c demo.php

Config File

Use the -c, --config switches to define the config file:

php bin/aerys -c /path/to/my/config.php

Use the -h, --help switches for more instructions.

Static File Serving

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 bobwei9@hotmail.com or me@kelunik.com instead of using the issue tracker.


The MIT License (MIT). Please see LICENSE for more information.