PHPackages                             roadrunner-php/version-checker - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. roadrunner-php/version-checker

ActiveLibrary[Utility & Helpers](/categories/utility)

roadrunner-php/version-checker
==============================

The package for checking the version of the RoadRunner

v1.1.0(3mo ago)21.9M↓25.4%3[2 PRs](https://github.com/roadrunner-php/version-checker/pulls)1MITPHPPHP ^8.0CI passing

Since May 25Pushed 3mo ago4 watchersCompare

[ Source](https://github.com/roadrunner-php/version-checker)[ Packagist](https://packagist.org/packages/roadrunner-php/version-checker)[ Docs](https://github.com/roadrunner-php/version-checker)[ GitHub Sponsors](https://github.com/roadrunner-server)[ RSS](/packages/roadrunner-php-version-checker/feed)WikiDiscussions 1.x Synced 1mo ago

READMEChangelog (4)Dependencies (6)Versions (6)Used By (1)

RoadRunner VersionChecker
=========================

[](#roadrunner-versionchecker)

[![PHP Version Require](https://camo.githubusercontent.com/d10b70733a02332dfb52392d59cfac2d7da8b75a2d50936ecaf7bfa2a1455faf/68747470733a2f2f706f7365722e707567782e6f72672f726f616472756e6e65722d7068702f76657273696f6e2d636865636b65722f726571756972652f706870)](https://packagist.org/packages/roadrunner-php/version-checker)[![Latest Stable Version](https://camo.githubusercontent.com/e296117d97aaf0740e895f2bdc30f7e580814b72a46392641981c673f3a3bb01/68747470733a2f2f706f7365722e707567782e6f72672f726f616472756e6e65722d7068702f76657273696f6e2d636865636b65722f762f737461626c65)](https://packagist.org/packages/roadrunner-php/version-checker)[![phpunit](https://github.com/roadrunner-php/version-checker/actions/workflows/phpunit.yml/badge.svg)](https://github.com/roadrunner-php/version-checker/actions)[![psalm](https://github.com/roadrunner-php/version-checker/actions/workflows/psalm.yml/badge.svg)](https://github.com/roadrunner-php/version-checker/actions)[![Codecov](https://camo.githubusercontent.com/bc9b753e3af61ac9f49eae45a18996c4098858db19eef06522732674b3dcf027/68747470733a2f2f636f6465636f762e696f2f67682f726f616472756e6e65722d7068702f76657273696f6e2d636865636b65722f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/roadrunner-php/version-checker)[![Total Downloads](https://camo.githubusercontent.com/62cf755cd6f5dc61df5408b7fafa21134ec73e7c469c7629093249102aaf5cef/68747470733a2f2f706f7365722e707567782e6f72672f726f616472756e6e65722d7068702f76657273696f6e2d636865636b65722f646f776e6c6f616473)](https://packagist.org/roadrunner-php/version-checker/phpunit)[![](https://camo.githubusercontent.com/4442b73a11753b80fdd7b442ddbfaf8383902c8b9ffa66ed1718e8c62e102f2e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646973636f72642d636861742d6d6167656e74612e737667)](https://discord.gg/8bZsjYhVVk)

Requirements
------------

[](#requirements)

Make sure that your server is configured with following PHP version and extensions:

- PHP 8.0+

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require roadrunner-php/version-checker
```

Usage
-----

[](#usage)

Use the `RoadRunner\VersionChecker\VersionChecker` methods to check the compatibility of the installed RoadRunner version. The VersionChecker class has three public methods:

- **greaterThan** - Checks if the installed version of RoadRunner is **greater than or equal** to the specified version. If no version is specified, the minimum required version will be determined based on the minimum required version of the `spiral/roadrunner` package.
- **lessThan** - Checks if the installed version of RoadRunner is **less than or equal** to the specified version.
- **equal** - Checks if the installed version of RoadRunner is **equal** to the specified version.

All three methods throw an `RoadRunner\VersionChecker\Exception\UnsupportedVersionException` if the installed version of RoadRunner does not meet the specified requirements. If RoadRunner is not installed, a `RoadRunner\VersionChecker\Exception\RoadrunnerNotInstalledException` is thrown.

```
use RoadRunner\VersionChecker\VersionChecker;
use RoadRunner\VersionChecker\Exception\UnsupportedVersionException;

$checker = new VersionChecker();

try {
    $checker->greaterThan('2023.1');
} catch (UnsupportedVersionException $exception) {
    var_dump($exception->getMessage()); // Installed RoadRunner version `2.12.3` not supported. Requires version `2023.1` or higher.
    var_dump($exception->getInstalledVersion()); // 2.12.3
    var_dump($exception->getRequestedVersion()); // 2023.1
}

try {
    $checker->lessThan('2.11');
} catch (UnsupportedVersionException $exception) {
    var_dump($exception->getMessage()); // Installed RoadRunner version `2.12.3` not supported. Requires version `2.11` or lower.
    var_dump($exception->getInstalledVersion()); // 2.12.3
    var_dump($exception->getRequestedVersion()); // 2.11
}

try {
    $checker->equal('2.11');
} catch (UnsupportedVersionException $exception) {
    var_dump($exception->getMessage()); // Installed RoadRunner version `2.12.3` not supported. Requires version `2.11`.
    var_dump($exception->getInstalledVersion()); // 2.12.3
    var_dump($exception->getRequestedVersion()); // 2.11
}
```

### Path to the RoadRunner binary

[](#path-to-the-roadrunner-binary)

To configure the `VersionChecker` to search for the RoadRunner binary in a location other than the default (application root with a rr filename), you can bind the `RoadRunner\VersionChecker\Version\InstalledInterface`within application container using the `RoadRunner\VersionChecker\Version\Installed` class and passing the desired file path as the **$executablePath** parameter. After that, you can retrieve the VersionChecker class from application container.

Example with Spiral Framework container:

```
use RoadRunner\VersionChecker\Version\InstalledInterface;
use RoadRunner\VersionChecker\Version\Installed;

$container->bindSingleton(InstalledInterface::class, new Installed(executablePath: 'some/path'));
$checker = $container->get(VersionChecker::class);
```

Testing
-------

[](#testing)

```
composer test
```

```
composer psalm
```

```
composer cs
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

53

—

FairBetter than 97% of packages

Maintenance82

Actively maintained with recent releases

Popularity46

Moderate usage in the ecosystem

Community20

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 70.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~249 days

Total

5

Last Release

90d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/796136?v=4)[Anton Tsitou](/maintainers/wolfy-j)[@wolfy-j](https://github.com/wolfy-j)

---

Top Contributors

[![msmakouz](https://avatars.githubusercontent.com/u/67324318?v=4)](https://github.com/msmakouz "msmakouz (17 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (4 commits)")[![novikoff-vvs](https://avatars.githubusercontent.com/u/194783368?v=4)](https://github.com/novikoff-vvs "novikoff-vvs (1 commits)")[![rustatian](https://avatars.githubusercontent.com/u/8040338?v=4)](https://github.com/rustatian "rustatian (1 commits)")[![xepozz](https://avatars.githubusercontent.com/u/6815714?v=4)](https://github.com/xepozz "xepozz (1 commits)")

---

Tags

phproadrunnerroadrunnerroadrunner-phpversion-checker

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/roadrunner-php-version-checker/health.svg)

```
[![Health](https://phpackages.com/badges/roadrunner-php-version-checker/health.svg)](https://phpackages.com/packages/roadrunner-php-version-checker)
```

###  Alternatives

[symfony/maker-bundle

Symfony Maker helps you create empty commands, controllers, form classes, tests and more so you can forget about writing boilerplate code.

3.4k111.1M568](/packages/symfony-maker-bundle)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[orchestra/canvas

Code Generators for Laravel Applications and Packages

20917.2M158](/packages/orchestra-canvas)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19562.3M1.3k](/packages/drupal-core)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

728272.9k20](/packages/civicrm-civicrm-core)[kimai/kimai

Kimai - Time Tracking

4.6k7.4k1](/packages/kimai-kimai)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)