RoadRunner ⇆ Laravel bridge
Easy way for connecting RoadRunner and Laravel applications.
Install
Require this package with composer using next commands:
$ composer require avto-dev/roadrunner-laravel "^3.0"
Installed
composeris required (how to install composer).
You need to fix the major version of package.
Previous major versions still available, but it's development is abandoned. Use only latest major version!
After that you can "publish" package configuration file (./config/roadrunner.php) using next command:
$ php ./artisan vendor:publish --provider='AvtoDev\RoadRunnerLaravel\ServiceProvider' --tag=config
And basic RoadRunner configuration file (./.rr.yaml.dist):
$ php ./artisan vendor:publish --provider='AvtoDev\RoadRunnerLaravel\ServiceProvider' --tag=rr-config
If you wants to disable package service-provider auto discover, just add into your composer.json next lines:
{
"extra": {
"laravel": {
"dont-discover": [
"avto-dev/roadrunner-laravel"
]
}
}
}
After that you can modify configuration files as you wish.
Important: despite the fact that worker allows you to refresh application instance on each HTTP request (if environment variable APP_REFRESH set to true), we strongly recommend to avoid this for performance reasons. Large applications can be hard to integrate with RoadRunner (you must decide which of service providers must be reloaded on each request, avoid "static optimization" in some cases), but it's worth it.
Usage
After package installation you can use provided "binary" file as RoadRunner worker: ./vendor/bin/rr-worker. This worker allows you to interact with incoming requests and outcoming responses using laravel events system. Also events contains:
Event classname, Application object, HTTP server request, HTTP request, HTTP response
----------------------------, :----------------:, :-----------------:, :----------:, :-----------:
BeforeLoopStartedEvent, ✔, BeforeLoopIterationEvent, ✔, ✔, BeforeRequestHandlingEvent, ✔, ✔, AfterRequestHandlingEvent, ✔, ✔, ✔
AfterLoopIterationEvent, ✔, ✔, ✔
AfterLoopStoppedEvent, ✔, ### Listeners
This package provides event listeners for resetings application state without full application reload (like cookies, HTTP request, application instance, service-providers and other). Some of them already declared in configuration file, but you can declare own without any limitations.
Environment variables
You can use the following environment variables:
Variable name, Description
-----------------, -----------
APP_FORCE_HTTPS, (declared in configuration file) Forces application HTTPS schema usage
APP_REFRESH, Refresh application instance on every request
Testing
For package testing we use phpunit framework and docker-ce + docker-compose as develop environment. So, just write into your terminal after repository cloning:
$ make build
$ make latest # or 'make lowest'
$ make test
Changes log
Changes log can be found here.
Support
If you will find any package errors, please, make an issue in current repository.
License
This is open-sourced software licensed under the MIT License.