Download the PHP package quioteframework/worker-roadrunner without Composer

On this page you can find all versions of the php package quioteframework/worker-roadrunner. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of quioteframework/worker-roadrunner

Informations about the package worker-roadrunner

quioteframework/worker-roadrunner

Runs a Quiote application as a RoadRunner PSR-7 worker, via the roadrunner alias of Quiote's worker-runtime seam (Quiote\Runtime\Worker\WorkerRuntimeInterface).

Developed in-tree under quioteframework/quiote's packages/worker-roadrunner/. PRs go to the monorepo, not here.

Install

Then activate the plugin in Config/plugins.xml, like any other Quiote plugin — installing the package alone does not switch anything on:

Set up

RoadRunner spawns workers by running a PHP script, so the app needs an entrypoint next to (not inside) its document root. quiote new --runtime=roadrunner generates both files below; for an existing app, add them by hand.

worker.php in the application root — the same shape as pub/index.php, with the runtime pinned:

.rr.yaml:

Then rr serve. Detection is automatic — RoadRunner sets $RR_MODE=http for its workers — so 'worker_runtime' => 'roadrunner' is belt-and-braces rather than required. It is worth keeping: an explicit runtime that turns out not to be hosting the process fails at startup instead of quietly degrading to one-request-per-process.

pub/index.php stays as it is, so the same codebase still runs under FrankenPHP or php-fpm unchanged.

What changes when you leave the SAPI

RoadRunner runs workers under the CLI SAPI, which is a bigger shift than "same app, different server". Quiote absorbs most of it, but not all:

Behaviour
Superglobals Hydrated per request from the PSR-7 request ($_SERVER, $_GET, $_POST, $_COOKIE) and cleared afterwards, so Routing, ext/session and other legacy readers keep working.
$_FILES Populated but without tmp_name — a PSR-7 upload may have no file behind it. Use $request->getUploadedFiles().
header() / setcookie() No-ops. Set headers on the PSR-7 response instead.
Native sessions The Set-Cookie PHP would normally emit itself is synthesised onto the response, so the legacy Quiote\Storage session path still establishes sessions.
echo outside a template Captured and appended to the response body rather than corrupting RoadRunner's relay. Configurable via core.worker.stray_output (append, discard, throw).
SSE / streaming Supported: each SseEvent is sent as its own frame. RoadRunner gives no client-disconnect signal to the worker, so an endless stream ends when the server tears the worker down.
Logging to stdout Stdout is the relay. Point stream sinks at php://stderr, which RoadRunner forwards to its own log.

Worker recycling

Leave it to RoadRunner (http.pool.max_jobs, max_worker_memory) and keep core.worker.max_requests at its default of 0. Stopping the loop from PHP mid-pool looks like a crashed worker to the server.

Settings

Setting Default Meaning
worker.roadrunner.chunk_size 8192 Upper bound on bytes per streamed frame. Events smaller than this are still sent immediately, one frame each.

All versions of worker-roadrunner with dependencies

PHP Build Version
Package Version
Requires php Version >=8.5.0
nyholm/psr7 Version ^1.8
quioteframework/quiote Version ^4.0
spiral/roadrunner-http Version ^3.5
spiral/roadrunner-worker Version ^3.6
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package quioteframework/worker-roadrunner contains the following files

Loading the files please wait ...