yiisoft / yii-runner-roadrunner
Web application runner for RoadRunner
Fund package maintenance!
Opencollective
yiisoft
Installs: 3 850
Dependents: 1
Suggesters: 1
Security: 0
Stars: 31
Watchers: 18
Forks: 8
Open Issues: 2
Requires
- php: ^8.1
- psr/container: ^2.0
- psr/http-factory: ^1.0
- psr/http-message: ^1.0|^2.0
- spiral/roadrunner: ^2023.1.0|^2024.1.0
- spiral/roadrunner-cli: ^2.5.0
- spiral/roadrunner-grpc: ^3.0.0
- spiral/roadrunner-http: ^v3.0.0
- spiral/roadrunner-worker: ^3.0.0
- yiisoft/config: ^1.1
- yiisoft/definitions: ^1.0|^2.0|^3.0
- yiisoft/di: ^1.0
- yiisoft/error-handler: ^3.0
- yiisoft/http: ^1.2
- yiisoft/log: ^2.0
- yiisoft/log-target-file: ^3.0
- yiisoft/yii-http: ^1.0
- yiisoft/yii-runner: ^2.0
Requires (Dev)
- grpc/grpc: ^1.50.0
- httpsoft/http-message: ^1.0
- maglnet/composer-require-checker: ^4.2
- phpunit/phpunit: ^10.3
- rector/rector: ^1.0.0
- roave/infection-static-analysis-plugin: ^1.16
- spatie/phpunit-watcher: ^1.23
- vimeo/psalm: ^5.22
- yiisoft/middleware-dispatcher: ^5.0
- yiisoft/test-support: ^3.0
This package is auto-updated.
Last update: 2024-10-22 20:54:40 UTC
README
Yii RoadRunner Runner
The package contains a bootstrap for running Yii3 applications using RoadRunner.
Requirements
- PHP 8.1 or higher.
Installation
The package could be installed with Composer:
composer require yiisoft/yii-runner-roadrunner
General usage
Get RoadRunner:
./vendor/bin/rr get
Create worker.php
in your application root directory:
use Yiisoft\Yii\Runner\RoadRunner\RoadRunnerHttpApplicationRunner; ini_set('display_errors', 'stderr'); require_once __DIR__ . '/autoload.php'; (new RoadRunnerHttpApplicationRunner( rootPath: __DIR__, debug: $_ENV['YII_DEBUG'], checkEvents: $_ENV['YII_DEBUG'], environment: $_ENV['YII_ENV'] ))->run();
Specify it in your .rr.yaml
:
version: '3' server: command: "php ./worker.php" rpc: listen: tcp://127.0.0.1:6001 http: address: :8082 pool: num_workers: 8 # Debug mode for the pool. In this mode, pool will not pre-allocate the worker. # Worker (only 1, num_workers ignored) will be allocated right after the request arrived. debug: false middleware: ["static", "headers"] static: dir: "./public" forbid: [".php", ".htaccess"] headers: response: "Cache-Control": "no-cache" logs: mode: production level: warn
Note: Official configuration reference. You can also activate
RoadRunner
schema in your IDE to get autocompletion hints.
Run RoadRunner with the config specified:
./rr serve
Additional configuration
By default, the RoadRunnerHttpApplicationRunner
is configured to work with Yii application templates and follows the
config groups convention.
You can override the default configuration using constructor parameters and immutable setters.
Constructor parameters
$rootPath
— the absolute path to the project root.
$debug
— whether the debug mode is enabled.
$checkEvents
— whether check events' configuration.
$environment
— the environment name.
$bootstrapGroup
— the bootstrap configuration group name.
$eventsGroup
— the events' configuration group name.
$diGroup
— the container definitions' configuration group name.
$diProvidersGroup
— the container providers' configuration group name.
$diDelegatesGroup
— the container delegates' configuration group name.
$diTagsGroup
— the container tags' configuration group name.
$paramsGroup
— the config parameters group name.
$nestedParamsGroups
— configuration group names that are included into config parameters group. This is needed for
recursive merge parameters.
$nestedEventsGroups
— configuration group names that are included into events' configuration group. This is needed for
reverse and recursive merge events' configurations.
Immutable setters
If the configuration instance settings differ from the default you can specify a customized configuration instance:
/** * @var Yiisoft\Config\ConfigInterface $config * @var Yiisoft\Yii\Runner\RoadRunner\RoadRunnerHttpApplicationRunner $runner */ $runner = $runner->withConfig($config);
The default container is Yiisoft\Di\Container
. But you can specify any implementation
of the Psr\Container\ContainerInterface
:
/** * @var Psr\Container\ContainerInterface $container * @var Yiisoft\Yii\Runner\RoadRunner\RoadRunnerHttpApplicationRunner $runner */ $runner = $runner->withContainer($container);
In addition to the error handler that is defined in the container, the runner uses a temporary error handler. A temporary error handler is needed to handle the creation of configuration and container instances, then the error handler configured in your application configuration will be used.
By default, the temporary error handler uses HTML renderer and logging to a file. You can override this as follows:
/** * @var Psr\Log\LoggerInterface $logger * @var Yiisoft\ErrorHandler\Renderer\PlainTextRenderer $renderer * @var Yiisoft\Yii\Runner\RoadRunner\RoadRunnerHttpApplicationRunner $runner */ $runner = $runner->withTemporaryErrorHandler( new Yiisoft\ErrorHandler\ErrorHandler($logger, $renderer), );
You can also use your own implementation of the Spiral\RoadRunner\Http\PSR7WorkerInterface
(default is a Spiral\RoadRunner\Http\PSR7Worker
):
/** * @var Spiral\RoadRunner\Http\PSR7WorkerInterface $psr7Worker * @var Yiisoft\Yii\Runner\RoadRunner\RoadRunnerHttpApplicationRunner $runner */ $runner = $runner->withPsr7Worker($psr7Worker);
Documentation
- Guide: English, Português - Brasil, Русский
- Internals
If you need help or have a question, the Yii Forum is a good place for that. You may also check out other Yii Community Resources.
License
The Yii RoadRunner Runner is free software. It is released under the terms of the BSD License.
Please see LICENSE
for more information.
Maintained by Yii Software.