PHPackages                             onhover/runcloud-sdk - 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. [API Development](/categories/api)
4. /
5. onhover/runcloud-sdk

ActiveLibrary[API Development](/categories/api)

onhover/runcloud-sdk
====================

RunCloud PHP SDK (Unofficial)

v1.1.1(6y ago)4151↓100%3[1 PRs](https://github.com/onhovercode/runcloud-sdk/pulls)MITPHPPHP ^7.0

Since Aug 21Pushed 4y agoCompare

[ Source](https://github.com/onhovercode/runcloud-sdk)[ Packagist](https://packagist.org/packages/onhover/runcloud-sdk)[ RSS](/packages/onhover-runcloud-sdk/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (1)Versions (6)Used By (0)

RunCloud API PHP SDK
====================

[](#runcloud-api-php-sdk)

This SDK helps you make API calls to the [RunCloud](https://runcloud.io) Version 2 API and is a fork of the [RunCloud PHP SDK](https://github.com/16bitsrl/runcloud-php-sdk).

[RunCloud API Documentation](https://runcloud.io/docs/api)

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

[](#installation)

Install the SDK in your project using Composer:

```
composer require onhover/runcloud-sdk

```

Use Composer's autoload:

```
require __DIR__ . '/../vendor/autoload.php';
```

Create an instance of the SDK:

```
$runcloud = new OnHover\RunCloud\RunCloud('MY_API_KEY', 'MY_API_SECRET');
```

Usage
-----

[](#usage)

You can use the `$runcloud` instance to make all available API calls.

To find out all available methods, inspect the appropriate classes in the `Actions`directory. The names of these classes and functions closely follow the [RunCloud API Documentation](https://runcloud.io/docs/api).

Examples
--------

[](#examples)

```
$response = $runcloud->ping();
```

This tests the connection to the API and should return the string "pong".

```
$servers = $runcloud->servers();
```

This will return an array of servers you have access to. Each array item will be an instance of `OnHover\RunCloud\Resources\Server` and contains various properties such as `id`, `name`, `provider` and `ipAddress`.

You can return a single Server instance like this:

```
$serverId = 12345;
$server = $runcloud->server($serverId);
```

Some methods require parameters to be supplied as an array.

```
$serverId = 12345;

$data = [
	'type' => 'global',
	'port' => '8080-8081',
	'protocol' => 'tcp',
];

$rule = $runcloud->createFirewallRule($serverId, $data);
```

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Mattia Trapani](https://github.com/zupolgec)
- [Pier Trapani](https://github.com/piertrapani)

This package uses code from and is greatly inspired by the [Forge SDK package](https://github.com/themsaid/forge-sdk) by [Mohammed Said](https://github.com/themsaid) and the [Oh Dear PHP SDK package](https://github.com/ohdearapp/ohdear-php-sdk).

License
-------

[](#license)

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

###  Health Score

29

—

LowBetter than 62% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90.5% 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 ~11 days

Total

4

Last Release

2372d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b340fcba8440336bbf4b073bacdbafd9b182b78da33c98ace85421bcac488978?d=identicon)[craigrodway](/maintainers/craigrodway)

---

Top Contributors

[![craigrodway](https://avatars.githubusercontent.com/u/83069?v=4)](https://github.com/craigrodway "craigrodway (38 commits)")[![zupolgec](https://avatars.githubusercontent.com/u/161318?v=4)](https://github.com/zupolgec "zupolgec (3 commits)")[![piertrapani](https://avatars.githubusercontent.com/u/1773650?v=4)](https://github.com/piertrapani "piertrapani (1 commits)")

---

Tags

apiphpruncloudsdkapisdkruncloud

### Embed Badge

![Health badge](/badges/onhover-runcloud-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/onhover-runcloud-sdk/health.svg)](https://phpackages.com/packages/onhover-runcloud-sdk)
```

###  Alternatives

[transbank/transbank-sdk

Transbank SDK

62611.7k11](/packages/transbank-transbank-sdk)[jeffreyhyer/bamboohr

PHP SDK for the BambooHR API

1074.3k1](/packages/jeffreyhyer-bamboohr)[clever/clever-php

231.6k](/packages/clever-clever-php)

PHPackages © 2026

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