amphp/aerys

This package is abandoned and no longer maintained. The author suggests using the amphp/http-server package instead.

A non-blocking HTTP/Websocket server

v0.7.4 2017-12-20 03:30 UTC

Requires

• php: >=7
• amphp/amp: ^2
• amphp/byte-stream: ^1
• amphp/file: ^0.2 || ^0.3
• amphp/socket: ^0.10
• league/climate: ^3
• nikic/fast-route: ^1
• ocramius/package-versions: ^1.1
• psr/log: ^1

Requires (Dev)

• amphp/artax: ^3
• amphp/phpunit-util: ^1
• friendsofphp/php-cs-fixer: ^2.3
• http2jp/hpack-test-case: ^1
• phpunit/phpunit: ^6

MIT

• Daniel Lowrey
• Bob Weinand
• Niklas Keller
• Aaron Piotrowski

• http
• websocket
• server
• async
• non-blocking
• amp
• amphp
• aerys

README

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

Deprecation

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

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).

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"));

Security

If you discover any security related issues, please email [e-mail] or [e-mail] instead of using the issue tracker.

License

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