README

The scalable hateoas server

##Major Dependencies

• silex
• react
• reactive-silex
• hateoas
• hateoas-silex integration

##Instal

The recommended way to install kpacha/reactive-hateoas is through composer.

{
    "require": {
        "kpacha/reactive-hateoas": "~0.1.0"
    }
}

##Usage

Check out the bin/reactive.php example and run it with

$ php bin/reactive.php

There is a built-in console-based script

$ bin/run list
Console Tool

Usage:
  [options] command [arguments]

Options:
  --help           -h Display this help message.
  --quiet          -q Do not output any message.
  --verbose        -v|vv|vvv Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
  --version        -V Display this application version.
  --ansi              Force ANSI output.
  --no-ansi           Disable ANSI output.
  --no-interaction -n Do not ask any interactive question.

Available commands:
  help       Displays help for a command
  list       Lists commands
  reactive   Start a reactive-silex instance

$ bin/run reactive -vv 8080
Server running at http://127.0.0.1:8080
Memory: 1280 KiB
Memory: 1280 KiB

##Api Consumption

See the nice examples at mcuadros's repo.

##Scalability

React launches a single-process share-nothing server, so you can instance several stacks in a single machine, depending on the number of avilable cores, before scale-out adding more hardware. The cpu and memory consumption will remain almost lineal. Balance your load between your stacks and everything will be run like a charm!

Also, remember to bind every stack to a different port or you will face some nice port collision messages!