3.0.0 (2026-10-12)

⚠ BREAKING CHANGES

• generate a configuration that RoadRunner 3 accepts (#74)
• the tcp, websockets, broadcast and reload plugins are removed: RoadRunner 3 does not ship them.
• the Command, Configuration and Downloader namespaces move to Spiral\RoadRunner\Console\Internal\Option, Internal\Configuration and Internal\Downloader, and Environment\Stability, Environment\RoadRunnerVersion and Environment\Environment to Internal\Environment; all of them are internal now. The abstract Spiral\RoadRunner\Console\Command, Command\OptionInterface, Environment\Enum and both Environment\*\Factory classes are removed: the commands extend the Symfony command directly. The commands and Configuration\Generator are final. Environment\Environment::get() takes only the variable name, OperatingSystem::createFromGlobals() takes no arguments, Stability::all() returns a list, and RoadRunnerVersion::PACKAGE_NAME and DEFAULT_CONSTRAINT are private.
• the Spiral\RoadRunner\Console\Archive and Spiral\RoadRunner\Console\Repository namespaces are removed, Version1\StaticRepository included. Command::getRepository() and Command::confirm() are removed, and VersionFilterOption::find() and VersionFilterOption::choices() with them. VersionsCommand is final.
• for get-binary and download-protoc-binary, RR_GITHUB_API_URL must be https://api.github.com or end with /api/v3, and the token for a GitHub Enterprise Server is read from DLOAD_TOKEN_<HOST> (e.g. DLOAD_TOKEN_GHE_EXAMPLE_COM) instead of GITHUB_TOKEN. symfony/console and symfony/http-client 6.4 or newer are required.

Features

• add nsq, kafka, google_pub_sub, centrifuge and protoreg sections (82f9323)
• download binaries with DLoad (ca51088)
• keep version filters on the RoadRunner 3.x line (9df5936)
• make the wildcard version filter install RoadRunner 3.0 or newer (d787366)
• migrate tests to Testo, require PHP 8.2 (#56) (71c3f7e)
• read the GitHub API URL from RR_GITHUB_API_URL (#65) (eff8b50)
• support RoadRunner v3 (#48) (75a848d)

Bug Fixes

• do not write .rr.yaml when its generation fails (ad5bf6d)
• generate a configuration that RoadRunner 3 accepts (#74) (82f9323)
• pick the rr versions token like DLoad does (1592cd4)

Documentation

• describe musl selection and DLoad side effects (7a6563b)
• note that 3.x targets RoadRunner v3 (28ecf5b)
• point the empty DLoad config at the moved downloader class (d38492e)
• refresh the README (#53) (623354c)

Code Refactoring

• add #[\Override] and drop the psalm baseline (#64) (d8a5b3f)
• list the configuration sections without spiral/tokenizer (58e6301)
• move the implementation into the Internal namespace (54d3b8a)
• remove the archive and release repository classes (f86cecd)
• resolve the Psalm baseline in code (d8a5b3f)

What's Changed

• Support Symfony 8.0 by @Nyholm in https://github.com/roadrunner-php/cli/pull/47 Fixed deprecations

New Contributors

• @Nyholm made their first contribution in https://github.com/roadrunner-php/cli/pull/47

Full Changelog: https://github.com/roadrunner-php/cli/compare/v2.7.1...v2.7.2

What's Changed

• Included amd64 into X86-64 mapping

Full Changelog: https://github.com/roadrunner-php/cli/compare/v2.7.0...v2.7.1

What's Changed

• Fix documentation links by @msmakouz in https://github.com/roadrunner-php/cli/pull/45
• Maintenance by @roxblnfk in https://github.com/roadrunner-php/cli/pull/46
  • Updated dependencies
  • Applied Spiral Code Style
    • Resolved PHP 8.4 deprecations
  • Added CI actions for CS fixing; psalm
  • Added Funding metadata

New Contributors

• @roxblnfk made their first contribution in https://github.com/roadrunner-php/cli/pull/46

Full Changelog: https://github.com/roadrunner-php/cli/compare/v2.6.0...v2.7.0

What's Changed

• Update dependencies by @msmakouz in https://github.com/roadrunner-php/cli/pull/44

Full Changelog: https://github.com/roadrunner-php/cli/compare/v2.5.0...v2.6.0

What's Changed

• Added new --no-config option to GetBinaryCommand, to skip generating config by @acelaya in https://github.com/roadrunner-php/cli/pull/38
• Updating config version, adding otel by @msmakouz in https://github.com/roadrunner-php/cli/pull/42

New Contributors

• @acelaya made their first contribution in https://github.com/roadrunner-php/cli/pull/38

Full Changelog: https://github.com/roadrunner-php/cli/compare/v2.4.0...v2.5.0

What's Changed

• Added command for RoadRunner config generation by @butschster in https://github.com/spiral/roadrunner-cli/pull/39

Full Changelog: https://github.com/spiral/roadrunner-cli/compare/v2.3.0...v2.4.0

What's Changed

Adding the ability to generate a configuration file

Using the plugin option (shortcut p) you can generate an example of configuration file with the only plugins you need.

For example, with http plugin only:

./vendoor/bin/get-binary -p http

http and jobs:

./vendoor/bin/get-binary -p http -p jobs

Available plugins:

• amqp,
• beanstalk,
• boltdb,
• broadcast,
• endure,
• fileserver,
• grpc,
• http,
• jobs,
• kv,
• logs,
• metrics,
• nats,
• redis,
• reload,
• rpc,
• server,
• service,
• sqs,
• status,
• tcp,
• temporal,
• websockets.

by @msmakouz in https://github.com/spiral/roadrunner-cli/pull/30

Adding get-protoc-binary console command

Allows to install the latest version of the protoc-gen-php-grpc file compatible with your environment (operating system, processor architecture, runtime, etc...).

Just use the following command

./vendor/bin/download-protoc-binary

by @msmakouz in https://github.com/spiral/roadrunner-cli/pull/34

Full Changelog: https://github.com/spiral/roadrunner-cli/compare/v2.2.0...v2.3.0

What's Changed

• Exclude deb packages from downloadable binaries by @butschster in https://github.com/spiral/roadrunner-cli/pull/32

Full Changelog: https://github.com/spiral/roadrunner-cli/compare/v2.1.0...v2.2.0

Roadrunner binary repository moved to the new organization - https://github.com/roadrunner-server/roadrunner

Starting from the roadrunner-cli v2.1.0 versions of roadrunner binary lower than 2.7.0 are not supported. If you want to use roadrunner lower than 2.7.0 please use previous version of this package.

What's Changed

• Changes rr binary repo link. by @butschster in https://github.com/spiral/roadrunner-cli/pull/28

Full Changelog: https://github.com/spiral/roadrunner-cli/compare/v2.0.14...v2.1.0

What's Changed

• Add compatibility with symfony ^6.0

New Contributors

• @programmador made their first contribution in https://github.com/spiral/roadrunner-cli/pull/26

Full Changelog: https://github.com/spiral/roadrunner-cli/compare/v2.0.13...v2.0.14

What's Changed

• Fixes problem with downloading roadrunner binary by @butschster in https://github.com/spiral/roadrunner-cli/pull/24

New Contributors

• @butschster made their first contribution in https://github.com/spiral/roadrunner-cli/pull/24

• Fix arch autodetection on M1 Mac.

• Remove 2.0 alphas from predefined array

• Remove RR 1.0 release API requests

Added support for real (internal) and "pretty" (composer-compatible) release tags.

• This fixes a bug with an incorrect version for the config file (#18, https://github.com/laravel/octane/issues/387).

• Fix "Invalid version string" error (#15, #14)

• Stop asking to create config file if already exists in current dir (#11)
• Make binary executable after install (#12)

• Add aarch64 alias support (#10)

• Fix compatibility with symfony ^4.4 LTS components (#8)

• Actualize symfony dependecies (#7)

• Added arm64 in known arch list (#5)

• Using minimum stability instead strict stability comparison (#4)

• Added information about current environment (during installation and get a list of versions)
• Added --stability flag (default: stable)
• Added support for installing from spiral/roadrunner-binary repository

• Subsplit CLI tools from spiral/roadrunner-worker 2.0.1