NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #794 most downloaded on Packagist
RoadRunner: High-performance PHP application server and process manager written in Go and powered with plugins
Latest stable
v2025.1.15
Last release 1 months ago
21 Oct 2026
Release timing varies
gaps range from 2 weeks to 4 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
272 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
✒️ RPC plugin: ⚠️ RPC calls might be fired immediately on the first line of the code, FR, (thanks @roquie)
gRPC and temporal support, PR1, PR2, (thanks @cv65kr)aarch64 on the M1/2 macs, BUG, (thanks @daniellienert)Your coding agent can read these notes before it upgrades. Set up the MCP server →
✒️ Kafka plugin: Totally reworker Kafka plugin. Now it supports regexps for the topics, marked commits for the group consumers, and SASL authenticatio
✒️ Kafka plugin: Totally reworker Kafka plugin. Now it supports regexps for the topics, marked commits for the group consumers, and SASL authentication. Configuration reference: link.
✒️ Endure v2 support (internal change).
✒️ Bash script to download the latest RR archive. Later we're going to release a non archived binaries in addition to the regular archived releases. Sample of usage:
curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/roadrunner-server/roadrunner/master/download-latest.sh | sh
✒️ RoadRunner composer metapackage: Removed the require section: PR, (thanks @roxblnfk)
add the metrics prefix and labels options to the reference config and schema
🐛 Go security update: RoadRunner uses Go 1.27.3 to address CVE-2026-111943 in crypto/x509. The update rejects known untrusted intermediate certificate…
1.27.3 to address CVE-2026-111943 in crypto/x509. The update rejects known untrusted intermediate certificates during certificate verification. See BUG.RoadRunner v3 uses v6 Go plugins. See Upgrade from v2025 to v3 for the required configuration and API changes.
RoadRunner v3 uses v6 Go plugins. See Upgrade from v2025 to v3 for the required configuration and API changes.
github.com/roadrunner-server/roadrunner/v3. See Embedding a server.api, api-go/v6, and api-plugins/v6. Custom plugins use log/slog, pool/v2, and goridge/v4. See Writing a Plugin, PR.envfile without experimental mode. A configured file is required when the server starts. See Environment.dynamic_allocator.max_workers counts workers added above the base pool size. See Auto workers scaling, FR.server.on_init.env override inherited values. See Server, PR.http pluginhttp.middleware from left to right. Reverse a v5 list to keep its previous order. See Middleware order, PR.Upgrade: h2c is no longer supported. See HTTP/2.proxy_ip_parser middlewarehttp.trusted_headers. See Proxy IP parser, FR.static middlewarerr reset static. Weak ETags now use file size and modification time. See Static files, PR.rate_limiter middleware429 with Retry-After. See Rate limiter, FR.zstd middlewarezstd. See Zstd, FR.grpc plugingoogle.rpc.Status details in failed unary-call logs. See gRPC, FR.amqp driverconfig.connection and nested exchange and queue settings; AMQP config.version is removed. See RabbitMQ, FR.jobs pluginpool header selects the destination pool. See Jobs, PR.rr_jobs_jobs_requeue. Outcome and push totals use counters. See Metrics, FR.nsq drivernats driverack_wait for JetStream redelivery timing. See NATS, PR.kafka driverconsume_partitions to select topic partitions and starting offsets. See Kafka, PR.jobs plugin restarts the pipeline. The old consumer closes, and a pipeline in jobs.consume continues with a new consumer. If the restart of a configured pipeline fails, RoadRunner stops with an error. See Kafka, BUG.sqs driverbeanstalk driverlogger pluginlog/slog with JSON, text, and raw formats. Configure file destinations through output; built-in rotation and file_logger_options are removed. See Logger, FR.format placeholders and time_format to control log records and timestamps. See Logger, FR.lock pluginredis driversentinel_username and sentinel_password independently from Redis master credentials. Password-only Sentinel authentication remains supported. See Redis, FR.service pluginservice.Update. Existing processes keep their current settings; new processes use the updated values. PHP applications need client and DTO support for this method. See Service, FR.status plugin/livez as an alias for /health and /readyz as an alias for /ready. See HealthChecks, PR.otel plugincentrifuge pluginNotifyCacheEmpty event support and remove centrifuge.RateLimit. The new event needs matching PHP DTO and handler support. See Centrifuge.temporal pluginvelox builder[plugins.<name>], with module_name and tag. Support module replacements, exclusions, and repeatable build timestamps. The remote build server and Windows targets are removed. See Building a Server, PR.✒️ Composer.json: add contributors, funds, project description: PR, (thanks @roxblnfk)
roadrunner v2.12.31.20.✒️ AMQP plugin: Custom headers in AMQP driver, FR, (thanks @ykweb)
requests_queue, request_duration_seconds and request_total, PR, docs: link, (thanks @cv65kr)exec_timeout option, BUG, (thanks @Chi-teck)--silent flag, PR, (thanks @maximal)Special thanks: @benalf
🐛 X-Sendfile middleware: fix early return bug: PR
roadrunner v2.12.2✏ AMQP plugin: pass headers to the Queue declaration command to create quorum, lazy, etc. queues and provide additional options supported by RabbitMQ,
roadrunner v2.12.2Queue declaration command to create quorum, lazy, etc. queues and provide additional options supported by RabbitMQ, FR, (thanks @ykweb)requests_queue, request_duration_seconds and request_total, PR, docs: link, (thanks @cv65kr)✏ RR: Automatically set the GOMAXPROCS to match the container CPU quota.
roadrunner v2.12.1GOMAXPROCS to match the container CPU quota.Status to check the AMQP connection PR.prefetch option now works as expected. RR will not consume new JOBS when it reaches the prefetch limit, until already accepted messages are not ACK/NACK-ed.prefetch option now works as expected (see SQS). You can now emulate FIFO in memory by setting the prefetch option to 1.Thanks to our awesome contributors: @wolfy-j , @butschster , @roxblnfk , @kastahov , @msmakouz, @lyt8384 ❤️
Nothing published for this version
✏ New API to get the RR version and configuration in the JSON format -> rpc.Version, rpc.Config.
roadrunner v2.12.0websocket and broadcast plugins were replaced by the new centrifuge plugin. How to build RR with these deprecated plugins -> linksdk and api, updated to v3. There are no breaking changes; we moved all Go code from the api to sdk.✏ New API to get the RR version and configuration in the JSON format -> rpc.Version, rpc.Config.
✏ New API to get the correct number of the running services, including statistics about the processes -> server.Statuses.
✏ New option to show the service name in the logs:
# Show the name of the service in logs (e.g. service.some_service_1)
#
# Default: false
service_name_in_log: false
Birddog: link
metrics.Unregister.jobs:
pipelines:
example:
driver: amqp
config:
# Durable exchange
#
# Default: true
exchange_durable: true
# Auto-deleted exchange
#
# Default: false
exchange_auto_deleted: false
# Auto-deleted queue
#
# Default: false
queue_auto_deleted: false
reset_timeout:pool:
allocate_timeout: 10s
reset_timeout: 10s
destroy_timeout: 10s
centrifugo plugin.
Docs: PHP-libRoadRunner config:
version: "2.7"
centrifuge:
# Centrifugo server proxy address (docs: https://centrifugal.dev/docs/server/proxy#grpc-proxy)
#
# Optional, default: tcp://127.0.0.1:30000
proxy_address: "tcp://127.0.0.1:30000"
# gRPC server API address (docs: https://centrifugal.dev/docs/server/server_api#grpc-api)
#
# Optional, default: tcp://127.0.0.1:30000. Centrifugo: `grpc_api` should be set to true and `grpc_port` should be the same as in the RR's config.
grpc_api_address: tcp://127.0.0.1:30000
# Use gRPC gzip compressor
#
# Optional, default: false
use_compressor: true
# Your application version
#
# Optional, default: v1.0.0
version: "v1.0.0"
# Your application name
#
# Optional, default: roadrunner
name: "roadrunner"
# TLS configuration
#
# Optional, default: null
tls:
# TLS key
#
# Required
key: /path/to/key.pem
# TLS certificate
#
# Required
cert: /path/to/cert.pem
# Workers pool settings. link: https://github.com/roadrunner-server/roadrunner/blob/master/.rr.yaml#L812
#
# Optional, default: null (see default values)
pool: {}
protoc-gen-php-grpc plugin errorThanks to our awesome contributors: @wolfy-j, @andrey-tech, @butschster, @masterjus, @phroggyy, @rapita, @egonbraun, @tungfinblox ❤️
✏ All plugins: update to v3. This is done not because of some breaking change but because of the internal update.
v3. This is done not because of some breaking change but because of the internal update.jobs:
pipelines:
example:
driver: amqp
config:
# Durable exchange
#
# Default: true
exchange_durable: true
# Auto-deleted exchange
#
# Default: false
exchange_auto_deleted: false
# Auto-deleted queue
#
# Default: false
queue_auto_deleted: false
reset_timeout. Note that the pool.Reset is protected by mutexes, meaning that if you have some requests already in the pool, you'll have to wait for these requests to be processed. The reset_timeout does not count this time.pool:
allocate_timeout: 10s
reset_timeout: 10s
destroy_timeout: 10s
✏ Centrifugo plugin: New centrifugo plugin. This will replace existing broadcast + websockets plugins. FR. Docs: PHP-lib
websocket and broadcast plugins were replaced by the new centrifuge plugin.sdk and api updated to v3. There are no breaking changes except we moved all Go code from the api to sdk.centrifugo plugin. This will replace existing broadcast + websockets plugins. FR.
Docs: PHP-libRoadRunner config:
version: "2.7"
centrifuge:
# Centrifugo server proxy address (docs: https://centrifugal.dev/docs/server/proxy#grpc-proxy)
#
# Optional, default: tcp://127.0.0.1:30000
proxy_address: "tcp://127.0.0.1:30000"
# gRPC server API address (docs: https://centrifugal.dev/docs/server/server_api#grpc-api)
#
# Optional, default: 127.0.0.1:30000. Centrifugo: `grpc_api` should be set to true and `grpc_port` should be the same as in the RR's config.
grpc_api_address: 127.0.0.1:30000
# Use gRPC gzip compressor
#
# Optional, default: false
use_compressor: true
# Your application version
#
# Optional, default: v1.0.0
version: "v1.0.0"
# Your application name
#
# Optional, default: roadrunner
name: "roadrunner"
# TLS configuration
#
# Optional, default: null
tls:
# TLS key
#
# Required
key: /path/to/key.pem
# TLS certificate
#
# Required
cert: /path/to/cert.pem
# Workers pool settings. link: https://github.com/roadrunner-server/roadrunner/blob/master/.rr.yaml#L812
#
# Optional, default: null (see default values)
pool: {}
protoc-gen-php-grpc plugin error, BUG (thanks @rapita)✏ API v3: remove ALL Go code from the API repository. Now, API contains only the RR protobuf API. You don't need to import an interface from the API (
worker + sync worker (since there were no differences), pool + sync pool - now, if a user uses supervisor, pool automatically turns on supervisor under the hood.multipart-form files), BUG, (thanks @egonbraun)v3. They don't use API interfaces anymore.✏ Temporal plugin: Support for the SearchAttributes. FR, (thanks @cv65kr).
SearchAttributes. FR, (thanks @cv65kr).roadrunner-temporal plugin updated to: 1.7.0http plugin updated to: 2.23.5sqs plugin updated to: 2.20.4config plugin updated to: 2.16.5grpc plugin updated to: 2.23.3nats plugin updated to: 2.17.3jobs plugin updated to: 2.18.4server plugin updated to: 2.16.4tcp plugin updated to: 2.15.4websockets plugin updated to: 2.16.5otel plugin updated to: 2.5.6kafka plugin updated to: 2.2.3Nothing published for this version
✏ [ALPHA] gRPC plugin: buf remote plugins support for the protoc-gen-php-grpc plugin. FR, (thanks @rauanmayemir)
buf remote plugins support for the protoc-gen-php-grpc plugin. FR, (thanks @rauanmayemir)mTLS support. FR, (thanks @seregazhuk)temporal:
address: 127.0.0.1:7233
cache_size: 100000
activities:
num_workers: 4
tls:
key: client.key
cert: client.pem
root_ca: ca.cert
client_auth_type: require_and_verify_client_cert
server_name: "tls-sample"
yaml values. BUG, (thanks @lyt8384)base64 decoder for the google's ErrorProto structure. FR, (thanks @rauanmayemir)Nothing published for this version
…@cv65kr) Configuration stays the same (no breaking changes), but additionally, you may specify a driver:
✏ Kafka plugin: [ ⚠️ EXPERIMENTAL OPTION ⚠️ ] Kafka plugin now waits for 1 minute (automatically) for the broker to be available, FR, (thanks @Baiquette)
✏ Internal: PHP Worker now uses an FSM to transition between states (working, ready, invalid, etc).
✏ Internal: ./rr reset now works in parallel. All workers will be restarted simultaneously instead of a one-by-one sync approach.
✏ Internal: ./rr reset and destroy (when stopping RR) now gracefully stop the workers (giving a chance for the finalizers to work). If the worker doesn't respond in 10 seconds, it'll be killed.
AWS IMDSv2 instances, BUG (thanks @paulermo)stream not found error from NATS, BUG, (thanks @pjtuxe)statsd daemon for stats aggregation, FR, (thanks @cv65kr)
Configuration stays the same (no breaking changes), but additionally, you may specify a driver:Prometheus:
temporal:
address: "127.0.0.1:7233"
metrics:
driver: prometheus # <---- prometheus used by default (you may omit the driver in this case)
address: "127.0.0.1:9095"
prefix: "samples"
type: "summary"
activities:
num_workers: 4
Statsd:
temporal:
address: "127.0.0.1:7233"
metrics:
driver: statsd # <---- Should be specified to use a statsd driver
host_port: "127.0.0.1:8125"
prefix: "samples"
flush_interval: 1s
flush_bytes: 512
tags:
- foo: bar
activities:
num_workers: 4
Detailed description is here: link
✏ http plugin: Send raw body (unescaped) to the PHP worker for the application/x-www-form-urlencoded content type. FR1, FR2, (thanks @ekisu, @rlanting
application/x-www-form-urlencoded content type. FR1, FR2, (thanks @ekisu, @rlantingmove4mobile)
Configuration:http:
raw_body: true/false (by default)
client-name and client-version in Go client to represent PHP-SDK, FR, (thanks, @wolfy-j).rr.yaml configuration for the cache plugin. link✏️ [BETA]: RoadRunner: Can now be embedded in other go programs. PR, (thanks @khepin)
2.12.0 we plan to replace websockets and broadcast plugins with the centrifuge plugin. However, if you still need a RR with these deprecated plugins, you may use Velox to build your custom build.gRPC errors API. The exception might be passed as a Status structure in the Metadata (key - error) to be parsed and returned to the user w/o worker restart. NOTE: Status structure should be marshaled via proto marshaller, not json. FRcontext deadline exceeded error on worker's allocation. We updated the error message with the link to the docs with the most common causes for the worker allocation failed error: https://roadrunner.dev/docs/known-issues-allocate-timeout/2.x/en. Feel free to add your cases here :)folder, which can be used to specify the folder with the plugin in the repository. (thanks, @darkweak)replace directives. (thanks, @darkweak)Configuration:
temporal:
tls:
key: path/to/key
cert: path/to/cert
# other options
allocate_timeout from the pool to wait for the tcp/unix socket connection from the PHP worker. BUG, (thanks @Warxcell)github option is specified in the configuration.pool.allocate_timeout for the sockets/tcp relays instead of silently used of relay_timeout.raw logger mode. CH, (thanks @ilsenem)GO-SDK and API updated to the latest versions.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
✏️ OTEL Middleware: Support for the jaeger_agent exporter - FR, (thanks @L3tum)
jaeger_agent exporter - FR, (thanks @L3tum)OTEL SDK updated to v1.8.0google.golang.org/grpc updated to v1.48.0logger plugin updated to v2.13.5Go updated to v1.18.4🐛 SDK: In some cases, worker watcher might freeze if the user kills the worker right after allocation but before wait4 syscall and become a zombie. BU
wait4 syscall and become a zombie. BUGversion, buildtime, GitHub, and GitLab tokens in the velox.toml.CRC verification failed error. Starting from the v2.10.6, RR will show user-friendly message with the link to our docs on the most common causes for this type of error. Docs🐛 SDK: Increase stderr buffer size from 32kb to 64kb, man7-pipe_capacity, BUG, (thanks @7krasov)
stderr buffer size from 32kb to 64kb, man7-pipe_capacity, BUG, (thanks @7krasov)default routing key. BUG, (thanks @rauanmayemir)x-www-form-urlencoded requests 10Mb limit. BUG (thanks @StreetYo)🐛 Fix: incorrect reset behavior for the workers' pool.
reset behavior for the workers' pool.reset order for the RR and Temporal workers.Nothing published for this version
✏️ CLI: rr stop command. rr stop will read the .pid file to send a graceful-stop signal to the primary RR process (SIGTERM). To create a .pid file, ad
Configuration updated. Keep in mind, that until the stable release 1.0.0 configuration might be changed with breaking changes.
✏️ WORKER: Starting from this release, RR is able to show full error messages sent to the STDOUT during the worker bootstrap. FR (thanks @ykweb)
✏️ HTTP: Connection might be upgraded from the http/1.1 to h2c: rfc7540
Headers, which should be sent to upgrade connection:
Upgrade: h2cConnection: HTTP2-SettingsConnection: UpgradeHTTP2-Settings: AAMAAABkAARAAAAAAAIAAAAA RFC✏️ VELOX: Add GitLab support. Starting from the beta.2 you may use GitHub and GitLab plugins together. Configuration updated. Keep in mind, that until the stable release 1.0.0 configuration might be changed with breaking changes.
✏️ protoc-gen-php-grpc: Use of fully qualified names in place of imports. PR (thanks @ryanjcohen)
✏️ Jobs (queues) plugin now can consume any payload from the queue. If RR fails in converting payload into the Job structure, it'll create and fill al
Job structure, it'll create and fill all available fields manually. To turn on this feature, use consume_all: true in the driver configuration, e.g.:
Supported drivers: amqp, sqs,beanstalk,nats.jobs:
num_pollers: 10
pipeline_size: 100000
pool:
num_workers: 10
pipelines:
test-raw:
driver: sqs
config:
consume_all: true # <------- NEW OPTION
consume: [ "test-raw" ]
skip_queue_declaration: true sqs driver option. FR, (thanks @sergey-telpuk)jobs:
num_pollers: 10
pipeline_size: 100000
pool:
num_workers: 10
pipelines:
test-2:
driver: sqs
config:
skip_queue_declaration: true # <----- NEW OPTION
consume: [ "test-2" ]
Jaeger exporter and propagator.http:
address: 127.0.0.1:43239
max_request_size: 1024
middleware: [gzip, otel]
pool:
num_workers: 2
max_jobs: 0
allocate_timeout: 60s
destroy_timeout: 60s
otel:
exporter: jaeger # <----- NEW OPTION
mTLS authentication. Possible values for the client_auth_type are the same as for the gRPC (no_client_cert, request_client_cert,require_any_client_cert,verify_client_cert_if_given,require_and_verify_client_cert) FR, (thanks @fwolfsjaeger)version: '2.7'
server:
command: "php ../../php_test_files/http/client.php echo pipes"
relay: "pipes"
relay_timeout: "20s"
http:
address: :8085
max_request_size: 1024
middleware: [ ]
pool:
num_workers: 1
max_jobs: 0
allocate_timeout: 60s
destroy_timeout: 60s
ssl:
address: :8895
key: "key"
cert: "cert"
root_ca: "rootCA.pem" # <---- REQUIRED to use mTLS
client_auth_type: require_and_verify_client_cert # <---- NEW OPTION
logs:
mode: development
level: error
rr_auto_ack attribute won't fail the existing messages.✏️ [BETA] OpenTelemetry support. Starting from now, the new_relic middleware is deprecated, it'll receive only dependency updates and will be removed…
new_relic http middleware. Please, consider using the new OpenTelemetry middleware: otel.amd64 releases. FRv2.10.0, you can check every released binary with a provided *.asc key. For example:$ gpg --verify rr.asc
The openPGP key can be verified here: keyserver
Go programming language located here: link. To use it, just import the latest stable version go.buf.build/protocolbuffers/go/roadrunner-server/api latest.Service plugin now supports auto-reload. It can be added to the reload plugin targets and on change, it'll reload all underlying processes.AutoAck jobs option. For the messages (jobs), which are acceptable to lose. Or which execution can lead to a worker's stop (for example - OOM). FR, (thanks @hustlahusky)new_relic middleware is deprecated, it'll receive only dependency updates and will be removed from the RR bundle in the v2.12.0. (thanks @brettmc)
OpenTelemetry plugin supports the following exporters:
datadog, new relic.http or grpc clients.Configuration sample (stdout exporter):
http:
address: 127.0.0.1:43239
max_request_size: 1024
middleware: [gzip, otel]
pool:
num_workers: 2
max_jobs: 0
allocate_timeout: 60s
destroy_timeout: 60s
otel:
insecure: false
compress: true
exporter: stdout
service_name: rr_test
service_version: 1.0.0
New Relic exporter via http client: link
http:
address: 127.0.0.1:43239
max_request_size: 1024
middleware: [gzip, otel]
pool:
num_workers: 2
max_jobs: 0
allocate_timeout: 60s
destroy_timeout: 60s
otel:
insecure: false
compress: true
client: http
exporter: stdout
custom_url: ""
service_name: rr_test
service_version: 1.0.0
endpoint: otlp.eu01.nr-data.net:4318
headers:
- api-key: xxx # your api key here
PHP worker can access tracing data via w3c headers.
protoc-gen-php-grpc now supports optional fields. (thanks @genhoi)Service plugin output will be automatically trimmed. CHORE, (thanks, @OO00O0O)Full Changelog: https://github.com/roadrunner-server/roadrunner/compare/v2.10.0-rc.6...v2.10.0-rc.7
Full Changelog: https://github.com/roadrunner-server/roadrunner/compare/v2.10.0-rc.6...v2.10.0-rc.7
Full Changelog: https://github.com/roadrunner-server/roadrunner/compare/v2.10.0-rc.5...v2.10.0-rc.6
Full Changelog: https://github.com/roadrunner-server/roadrunner/compare/v2.10.0-rc.5...v2.10.0-rc.6
Full Changelog: https://github.com/roadrunner-server/roadrunner/compare/v2.10.0-rc.4...v2.10.0-rc.5
Full Changelog: https://github.com/roadrunner-server/roadrunner/compare/v2.10.0-rc.4...v2.10.0-rc.5
🐛 Fix: Service plugin: EPIPE on stdout/err writes. BUG, (thanks, @Grokon)
🐛 Fix: HTTP plugin: incorrect parent span propogation.
Full Changelog: https://github.com/roadrunner-server/roadrunner/compare/v2.10.0-rc.1...v2.10.0-rc.2
Full Changelog: https://github.com/roadrunner-server/roadrunner/compare/v2.10.0-rc.1...v2.10.0-rc.2
✏️ [BETA] OpenTelemetry support. Starting from now, the new_relic middleware is deprecated, it'll receive only dependency updates and will be removed…
amd64 releases.v2.10.0, every released binary can be checked with a provided *.asc key. For example:$ gpg --verify rr.asc
The openPGP key can be verified here: keyserver
Go programming language located here: link. To use it, just import the latest stable version go.buf.build/protocolbuffers/go/roadrunner-server/api latest.Service plugin now supports auto-reload. It can be added to the reload plugin targets and on change, it'll reload all underlying processes.AutoAck jobs option. For the messages (jobs), which are acceptable to lose. Or which execution can lead to a worker's stop (for example - OOM).new_relic middleware is deprecated, it'll receive only dependency updates and will be removed from the RR bundle in the v2.12.0.
OpenTelemetry plugin supports the following exporters:
datadog, new relic.http or grpc clients.Configuration sample (stdout exporter):
http:
address: 127.0.0.1:43239
max_request_size: 1024
middleware: [gzip, otel]
pool:
num_workers: 2
max_jobs: 0
allocate_timeout: 60s
destroy_timeout: 60s
otel:
insecure: false
compress: true
exporter: stdout
service_name: rr_test
service_version: 1.0.0
New Relic exporter via http client: link
http:
address: 127.0.0.1:43239
max_request_size: 1024
middleware: [gzip, otel]
pool:
num_workers: 2
max_jobs: 0
allocate_timeout: 60s
destroy_timeout: 60s
otel:
insecure: false
compress: true
client: http
exporter: stdout
custom_url: ""
service_name: rr_test
service_version: 1.0.0
endpoint: otlp.eu01.nr-data.net:4318
headers:
- api-key: xxx # your api key here
PHP worker can access tracing data via w3c headers.
Service plugin output will be automatically trimmed. CHORE, (thanks, @OO00O0O)✏️ [ALPHA] HTTP response streaming. Available only in the alfa builds.
Worker sample:
<?php
use Nyholm\Psr7\Factory\Psr17Factory;
use Nyholm\Psr7\Response;
use Nyholm\Psr7\Stream;
use Spiral\RoadRunner;
ini_set('display_errors', 'stderr');
require __DIR__ . "/vendor/autoload.php";
$worker = RoadRunner\Worker::create();
$psr7 = new RoadRunner\Http\PSR7Worker(
$worker,
new Psr17Factory(),
new Psr17Factory(),
new Psr17Factory()
);
$psr7->chunk_size = 10 * 10 * 1024;
$filename = 'file.tmp'; // big file or response
while ($req = $psr7->waitRequest()) {
try {
$fp = \fopen($filename, 'rb');
\flock($fp, LOCK_SH);
$resp = (new Response())->withBody(Stream::create($fp));
$psr7->respond($resp);
} catch (\Throwable $e) {
$psr7->getWorker()->error((string)$e);
}
Known issues:
🐛 Fix: HTTP plugin: request max body size incorrectly parsed. BUG, (thanks, @Opekunov)
✏️: --silent flag. This flag will hide the startup message and ./rr reset output.
--silent flag. This flag will hide the startup message and ./rr reset output.reset command (./rr reset) gets stuck when using output redirects. BUG, (thanks @maximal)🐛 Fix: incorrect -w flag behavior (set working dir). BUG, (thanks @rauanmayemir)
-w flag behavior (set working dir). BUG, (thanks @rauanmayemir)service plugin.🐛 Fix: incorrect usage of the ExecWithTTL SDK method which leads to skipping the exec_ttl supervisor option BUG (thanks @Baiquette)
trusted_subnets HTTP option will work only when proxy_ip_parser was added to the list of the middleware.ExecWithTTL SDK method which leads to skipping the exec_ttl supervisor option BUG (thanks @Baiquette)proxy_ip_parser HTTP middleware responsible for parsing X-Forwarded-For, Forwarded, True-Client-IP and X-Real-Ip.✏️ API: add service proto api to manage services, FR (thanks @butschster). Documentation is here: link.
amqp plugin when destroying pipelines.✏️ [ALPHA] HTTP response streaming. Starting from the v2.9.0, RR is capable of streaming responses. To turn on that feature, please, add the following
v2.9.0, RR is capable of streaming responses.
To turn on that feature, please, add the following lines to the configuration:experimental:
response_streams: true
Worker sample:
<?php
use Nyholm\Psr7\Factory\Psr17Factory;
use Nyholm\Psr7\Response;
use Nyholm\Psr7\Stream;
use Spiral\RoadRunner;
ini_set('display_errors', 'stderr');
require __DIR__ . "/vendor/autoload.php";
$worker = RoadRunner\Worker::create();
$psr7 = new RoadRunner\Http\PSR7Worker(
$worker,
new Psr17Factory(),
new Psr17Factory(),
new Psr17Factory()
);
$psr7->chunkSize = 10 * 10 * 1024;
$filename = 'file.tmp'; // big file or response
while ($req = $psr7->waitRequest()) {
try {
$fp = \fopen($filename, 'rb');
\flock($fp, LOCK_SH);
$resp = (new Response())->withBody(Stream::create($fp));
$psr7->respond($resp);
} catch (\Throwable $e) {
$psr7->getWorker()->error((string)$e);
}
}
Known issues:
🐛 Fix: Chdir (if the user sets the -w flag) before searching for the configuration.
-w flag) before searching for the configuration.🐛 Fix: Websocket access validator requests don't send cookies BUG, (@steffendietz)
Nothing published for this version
🧑🏭 Update all dependencies to the most recent versions.
🧑🏭 Update all dependencies to the most recent versions.
1.18✏️ Better env variables parser. Now RR is able to parse the sentences like: "mysql://${MYSQL_USER}:${MYSQL_PASSWORD}@${MYSQL_HOST}:${MYSQL_PORT}/${MYS
"mysql://${MYSQL_USER}:${MYSQL_PASSWORD}@${MYSQL_HOST}:${MYSQL_PORT}/${MYSQL_DATABASE}?serverVersion=5.7" and get all environment variables. FR, (reporter @Tony-Sol)configuration plugin from the root.go and other files. Used only in the serve where it should be.Docker: migrate to the trivy action instead of grype PR, (contributor: @tarampampam)
🐛 Fix: HTTP: incorrect middleware chain order BUG, (reporter @nitrogenium) `yaml http: middleware: ["static", "gzip"] `
http:
middleware: ["static", "gzip"]
Middleware executed from the right to left, i.e. first will be gzip and then static.
Forwarder header, RFC, FR (reporter @digitalkaoz)rr_activities_pool_queue_size and rr_workflows_pool_queue_size metrics. These metrics shows the number of activities/workflows waiting for the worker BUG, (reporter @Zylius)Queuer interface for the workers pool to show the number of requests waiting for the worker. Implemented in SDK.✏️ Timeout for the SQS create/get queue operations (30seconds) FR (reporter @sergey-telpuk)
v2.8.0 your .rr.yaml configuration version should be 2.7.version: '2.7' at the top.command:http:
address: 127.0.0.1:8080
max_request_size: 256
middleware: ["headers", "gzip"]
trusted_subnets: []
# Workers pool settings.
pool:
command: "php app.php" <---- NEW
This option overrides the server's command with the new one. The new command will inherit all server options. It can be used in any plugin (jobs, grpc, tcp, http, etc) using the workers' pool (http used here as a sample). No need to update your config. By default server command will be used as in the previous RR versions. Note, you can't leave the server command option empty. If you want to override the command in every plugin you use, put a placeholder in the server.command.
Rr_newrelic_ignore header support. Now you can send the Rr_newrelic_ignore:true header, and RR will ignore such transactions. RR will send no data to the newrelic server. FR (reporter @arku31)grpc plugin. Doc, FR (reporter @porozhnyy)Nothing published for this version
Nothing published for this version
One column per quarter.