phpbg/mini-httpd

This is a small http server framework built on top of react http. It allows to quickly build simple applications

Installs: 28

Dependents: 0

Suggesters: 0

Stars: 1

Watchers: 0

Forks: 0

Open Issues: 0

Language:JavaScript

0.4.2 2019-03-28 09:36 UTC

README

This is a small http server framework built on top of React HTTP.

This framework is designed to build quick proofs of concepts.

It is not mature enough to run in production environments, because:

  • it still contains synchronous blocking code
  • react http itself is not stable

License

MIT

Features

Most of features are directly inherited from PHP React HTTP

  • Middleware based
  • Highly customizable
  • PSR-7 messages
  • Basic routing
  • Basic PSR-3 logging
  • Static files serving
  • Let you focus on your service logic, not building a HTTP response (boooring)
    • Just return arrays or objects in your route handlers, that's it:
    function (ServerRequestInterface $request) {
        return ['hello' => 'world'];
    }

Install

Install with composer:

composer require phpbg/mini-httpd

Examples

See example folder

  • bare-minimal-json-server.php shows the very minimal setup for json rendering
  • full-featured-server.php shows a full setup with:
    • Static files serving
    • Route redirection examples
    • Automatic PHTML renderer features and suggested layout
    • Accessing request params with proper validation / filtering

There is also a complete example that integrates with ratchet Websockets here: https://github.com/phpbg/mini-httpd-ratchet

TODO

  • writing tests