PHPackages                             spiral/roadrunner-services - 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. spiral/roadrunner-services

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

spiral/roadrunner-services
==========================

RoadRunner services manager

2.3.0(3mo ago)977.6k↓18%61MITPHPPHP >=8.1CI passing

Since Apr 6Pushed 3mo ago5 watchersCompare

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

READMEChangelog (9)Dependencies (7)Versions (12)Used By (1)

[   ![](https://github.com/roadrunner-server/.github/assets/8040338/040fb694-1dd3-4865-9d29-8e0748c2c8b8) ](https://roadrunner.dev)Roadrunner services manager
===========================

[](#roadrunner-services-manager)

[![PHP Version Require](https://camo.githubusercontent.com/ce6aa4eb97c45b42cf73d67875c7978e96d90bfdec4f2e61c81d86c15e0d492d/68747470733a2f2f706f7365722e707567782e6f72672f73706972616c2f726f616472756e6e65722d73657276696365732f726571756972652f706870)](https://packagist.org/packages/spiral/roadrunner-services)[![Latest Stable Version](https://camo.githubusercontent.com/a483cbd0f7068639639d7571fded1be44a9a3f4e64be5532175957406bdaea68/68747470733a2f2f706f7365722e707567782e6f72672f73706972616c2f726f616472756e6e65722d73657276696365732f762f737461626c65)](https://packagist.org/packages/spiral/roadrunner-services)[![phpunit](https://github.com/spiral/roadrunner-services/actions/workflows/phpunit.yml/badge.svg)](https://github.com/spiral/roadrunner-services/actions)[![psalm](https://github.com/spiral/roadrunner-services/actions/workflows/psalm.yml/badge.svg)](https://github.com/spiral/roadrunner-services/actions)[![Total Downloads](https://camo.githubusercontent.com/4332815d76d2c327340ee463cfcbe43b0a543b4510482ff9643585bb408a3287/68747470733a2f2f706f7365722e707567782e6f72672f73706972616c2f726f616472756e6e65722d73657276696365732f646f776e6c6f616473)](https://packagist.org/packages/spiral/roadrunner-services)

This package will help you to manage [Roadrunner services](https://docs.roadrunner.dev/plugins/service)

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

[](#requirements)

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

- PHP 8.1+

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

[](#installation)

You can install the package via composer:

```
composer require spiral/roadrunner-services
```

Usage
-----

[](#usage)

Such a configuration would be quite feasible to run:

```
rpc:
  listen: tcp://127.0.0.1:6001

service: {}
```

Then you need to create an instance of `Spiral\RoadRunner\Services\Manager`

```
use Spiral\RoadRunner\Services\Manager;
use Spiral\Goridge\RPC\RPC;

$rpc = RPC::create('tcp://127.0.0.1:6001'));
$manager = new Manager($rpc);
```

### Create a new service

[](#create-a-new-service)

```
use Spiral\RoadRunner\Services\Exception\ServiceException;

try {
    $result = $manager->create(
        name: 'listen-jobs',
        command: 'php app.php queue:listen',
        processNum: 3,
        execTimeout: 0,
        remainAfterExit: false,
        env: ['APP_ENV' => 'production'],
        restartSec: 30
    );

    if (!$result) {
        throw new ServiceException('Service creation failed.');
    }
} catch (ServiceException $e) {
    // handle exception
}
```

### Check service status

[](#check-service-status)

```
use Spiral\RoadRunner\Services\Exception\ServiceException;

try {
    $status = $manager->statuses(name: 'listen-jobs');

    // Will return an array with statuses of every run process
    // [
    //    [
    //      'cpu_percent' => 59.5,
    //      'pid' => 33,
    //      'memory_usage' => 200,
    //      'command' => 'foo/bar',
    //      'error' => null
    //    ],
    //    [
    //      'cpu_percent' => 60.2,
    //      'pid' => 34,
    //      'memory_usage' => 189,
    //      'command' => 'foo/bar'
    //      'error' => [
    //          'code' => 1,
    //          'message' => 'Process exited with code 1'
    //          'details' => [...] // array with details
    //      ]
    //    ],
    // ]
} catch (ServiceException $e) {
    // handle exception
}
```

### Restart service

[](#restart-service)

```
use Spiral\RoadRunner\Services\Exception\ServiceException;

try {
    $result = $manager->restart(name: 'listen-jobs');

    if (!$result) {
        throw new ServiceException('Service restart failed.');
    }
} catch (ServiceException $e) {
    // handle exception
}
```

### Terminate service

[](#terminate-service)

```
use Spiral\RoadRunner\Services\Exception\ServiceException;

try {
    $result = $manager->terminate(name: 'listen-jobs');

    if (!$result) {
        throw new ServiceException('Service termination failed.');
    }
} catch (ServiceException $e) {
    // handle exception
}
```

### List of all services

[](#list-of-all-services)

```
use Spiral\RoadRunner\Services\Exception\ServiceException;

try {
    $services = $manager->list();

    // Will return an array with services names
    // ['listen-jobs', 'websocket-connection']
} catch (ServiceException $e) {
    // handle exception
}
```

###  Health Score

54

—

FairBetter than 97% of packages

Maintenance79

Regular maintenance activity

Popularity40

Moderate usage in the ecosystem

Community20

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 50% 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 ~139 days

Recently: every ~176 days

Total

11

Last Release

113d ago

Major Versions

1.1.0 → 2.0.02023-04-13

1.x-dev → 2.1.02023-07-12

PHP version history (2 changes)1.0.0PHP >=7.4

2.0.0PHP >=8.1

### Community

Maintainers

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

---

Top Contributors

[![butschster](https://avatars.githubusercontent.com/u/773481?v=4)](https://github.com/butschster "butschster (11 commits)")[![msmakouz](https://avatars.githubusercontent.com/u/67324318?v=4)](https://github.com/msmakouz "msmakouz (8 commits)")[![genhoi](https://avatars.githubusercontent.com/u/8273730?v=4)](https://github.com/genhoi "genhoi (1 commits)")[![rustatian](https://avatars.githubusercontent.com/u/8040338?v=4)](https://github.com/rustatian "rustatian (1 commits)")[![wispoz](https://avatars.githubusercontent.com/u/156639?v=4)](https://github.com/wispoz "wispoz (1 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/spiral-roadrunner-services/health.svg)

```
[![Health](https://phpackages.com/badges/spiral-roadrunner-services/health.svg)](https://phpackages.com/packages/spiral-roadrunner-services)
```

###  Alternatives

[temporal/sdk

Temporal SDK

4002.2M18](/packages/temporal-sdk)[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)[spiral/roadrunner-http

RoadRunner: HTTP and PSR-7 worker

799.2M48](/packages/spiral-roadrunner-http)[alibaba/nacos

阿里巴巴nacos配置中心php客户端

19340.8k1](/packages/alibaba-nacos)[keepsuit/laravel-temporal

Laravel temporal.io

4875.0k](/packages/keepsuit-laravel-temporal)[roadrunner-php/centrifugo

RoadRunner: Centrifugo bridge

131.6M4](/packages/roadrunner-php-centrifugo)

PHPackages © 2026

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