nigelgreenway/reactive-slim

A bridge to use SlimPHP within ReactPHP

![Build Status][ico-travis] , _(*1)

README

Reactive Slim is a bridge where you can pass your Slim instance and reap the benefit's of ReactPHP's event driven, non-blocking I/O usage of PHP., _(*2)

The implementation run's on PHP7.0 and makes good use of PHP's Scalar Type hints., _(*3)

Installation

composer require nigelgreenway/reactive-slim, _(*4)

Usage

After creating your Slim Instance, pass it to the following construction:, _(*5)

(new \ReactiveSlim\Server($slimInstance))
    ->run();

Please see the examples for more information or run php ./example/app-dev-mode.php., _(*6)

If are you are running via PHP locally, you are able to pass the following flags to customise both the host and the port:, _(*7)

-h 0.0.0.0 or --host=0.0.0.0 and -p 8686 or --port=8686, _(*8)

Restarting your ReactApp

There are 3 ways to restart your application (only tested on Linux - Solus, kernel 4.9.30-29.lts currently):, _(*9)

• sh ./.tools/local-watch runs via local PHP installation (requires inotify-tools to be installed via package manager)
• sh ./.tools/reactor run via local PHP installation and requires the reactor.config.json config
• sh ./.tools/docker-watch run the app within a Docker container (requires inotify-tools to be installed via package manager)

Extra options

#withHost(<string>) - The default host URL is 0.0.0.0 but is overridden by passing a string as the parameter, _(*10)

#withPort(<int>) - The default port is 1337 but is overridden by passing an integer as the parameter, _(*11)

#withEnvironment(<int>) - The default is 0 which is the Production environment, the full options are:, _(*12)

• ServerEnvironment::PRODUCTION (0)
• ServerEnvironment::STAGING (1)
• ServerEnvironment::TESTING (2)
• ServerEnvironment::DEVELOPMENT (3)

Change log

Please see CHANGELOG for more information on what has changed recently., _(*13)

Testing

bash $ composer test, _(*14)

Contributing

Please see CONTRIBUTING and CONDUCT for details., _(*15)

Security

If you discover any security related issues, please email :author_email instead of using the issue tracker., _(*16)

Credits

• Nigel Greenway
• All Contributors

This has been created to plug two great packages together: - SlimPHP - ReactPHP, _(*17)

License

The MIT License (MIT). Please see License File for more information., _(*18)