Download the PHP package avto-dev/roadrunner-laravel without Composer
On this page you can find all versions of the php package avto-dev/roadrunner-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download avto-dev/roadrunner-laravel
More information about avto-dev/roadrunner-laravel
Files in avto-dev/roadrunner-laravel
Package roadrunner-laravel
Short Description RoadRunner bridge for Laravel applications
License MIT
Informations about the package roadrunner-laravel
This package is abandoned and no longer maintained
We suggests using the spiral/roadrunner-laravel package instead
RoadRunner ⇆ Laravel bridge
Easy way for connecting RoadRunner and Laravel applications.
Installation
Require this package with composer using next command:
Installed
composer
is 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:
And basic RoadRunner configuration file (./.rr.yaml.dist
):
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 | Exception |
---|---|---|---|---|---|
BeforeLoopStartedEvent |
✔ | ||||
BeforeLoopIterationEvent |
✔ | ✔ | |||
BeforeRequestHandlingEvent |
✔ | ✔ | |||
AfterRequestHandlingEvent |
✔ | ✔ | ✔ | ||
AfterLoopIterationEvent |
✔ | ✔ | ✔ | ||
AfterLoopStoppedEvent |
✔ | ||||
LoopErrorOccurredEvent |
✔ | ✔ | ✔ |
Simple .rr.yaml
config example:
Roadrunner server starting:
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 |
Known issues
Controller constructors
You should avoid to use HTTP controller constructors (created or resolved instances in constructor can be shared between different requests). Use dependencies resolving in controller methods instead.
Bad:
Good:
Middleware constructors
You should never to use middleware constructor for session
, session.store
, auth
or auth Guard
instances resolving and storing in properties (for example). Use method-injection or access them through Request
instance.
Bad:
Good:
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:
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.
All versions of roadrunner-laravel with dependencies
ext-mbstring Version *
illuminate/contracts Version ^5.5 || ~6.0 || ~7.0
illuminate/support Version ^5.5 || ~6.0 || ~7.0
illuminate/http Version ^5.5 || ~6.0 || ~7.0
illuminate/routing Version ^5.5 || ~6.0 || ~7.0
spiral/roadrunner Version ~1.7
symfony/psr-http-message-bridge Version ^1.2 || ^2.0
laminas/laminas-diactoros Version ^2