amphp/aerys

A non-blocking HTTP/Websocket server

aerys

, _(*1)

Aerys is a non-blocking HTTP/1.1 and HTTP/2 application, WebSocket and static file server written in PHP based on Amp., _(*2)

Deprecation

This repository is deprecated in favor of amphp/http-server. It still exists to keep the documentation and also Packagist working as before., _(*3)

Installation

composer require amphp/aerys

Documentation

• Official Documentation
• Getting Started with Aerys
• Getting Started with Aerys WebSockets

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)., _(*4)

Add a -d switch to see some debug output like the routes called etc.:, _(*5)

php bin/aerys -d -c demo.php

Config File

Use the -c, --config switches to define the config file:, _(*6)

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

Use the -h, --help switches for more instructions., _(*7)

Static File Serving

To start a static file server simply pass a root handler as part of your config file., _(*8)

return (new Aerys\Host)
    ->expose("*", 1337)
    ->use(Aerys\root(__DIR__ . "/public"));

Security

If you discover any security related issues, please email bobwei9@hotmail.com or me@kelunik.com instead of using the issue tracker., _(*9)

License

The MIT License (MIT). Please see LICENSE for more information., _(*10)