PHPackages                             riidme/php-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. [Utility & Helpers](/categories/utility)
4. /
5. riidme/php-sdk

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

riidme/php-sdk
==============

Official PHP SDK for riid.me URL shortener service

v1.0.0(1y ago)01311PHPPHP ^8.3CI passing

Since Feb 21Pushed 1y ago1 watchersCompare

[ Source](https://github.com/prykris/riid.me-php)[ Packagist](https://packagist.org/packages/riidme/php-sdk)[ RSS](/packages/riidme-php-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (14)Versions (2)Used By (1)

Riid.me PHP SDK
===============

[](#riidme-php-sdk)

[![Latest Version on Packagist](https://camo.githubusercontent.com/8ca875b4b6d6088b05657f6060dec1e7f2b2cbbabfad308843311fa7f6eeb041/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726969646d652f7068702d73646b2e737667)](https://packagist.org/packages/riidme/php-sdk)[![Tests](https://github.com/prykris/riid.me-php/actions/workflows/tests.yml/badge.svg)](https://github.com/prykris/riid.me-php/actions/workflows/tests.yml)[![Total Downloads](https://camo.githubusercontent.com/5dea0585599d14062d461bd9c3c4251a538eefbeb0f952e498602843eaad3202/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f726969646d652f7068702d73646b2e737667)](https://packagist.org/packages/riidme/php-sdk)

Official PHP SDK for the riid.me URL shortener service. This package provides a clean and simple way to interact with the riid.me API.

📦 Related Packages
------------------

[](#-related-packages)

- [riidme/laravel](https://github.com/prykris/riid.me-laravel) - Laravel integration for riid.me

🔧 Requirements
--------------

[](#-requirements)

- PHP 8.3 or higher
- PSR-17 HTTP Factory implementation
- PSR-18 HTTP Client implementation

📥 Installation
--------------

[](#-installation)

You can install the package via composer:

```
composer require riidme/php-sdk
```

🚀 Usage
-------

[](#-usage)

```
use Riidme\Client;
use Riidme\Exception\RiidmeException;

// Initialize using factory method
$client = Client::create([
    'base_url' => 'https://riid.me',  // Optional
    'timeout'  => 5,                  // Optional
    'retries'  => 3                   // Optional
]);

try {
    $result = $client->shorten('https://example.com/very/long/url');
    echo $result->getShortUrl(); // https://riid.me/abc123
    // or simply
    echo $result; // https://riid.me/abc123
} catch (RiidmeException $e) {
    echo "Error: " . $e->getMessage();
}
```

🛠️ Laravel Integration
----------------------

[](#️-laravel-integration)

If you're using Laravel, check out our dedicated Laravel package [riidme/laravel](https://github.com/prykris/riid.me-laravel) which provides:

- Laravel service provider
- Facade for convenient access
- Laravel-specific configuration
- Integration with Laravel's HTTP client
- Automatic retry handling
- Queue support

✅ Testing
---------

[](#-testing)

```
composer test
```

🤝 Contributing
--------------

[](#-contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

📄 License
---------

[](#-license)

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

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance43

Moderate activity, may be stable

Popularity10

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

451d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/93e7e271e0595983da9185fa55e0f50d4816df02e194c4b8bc683d098887e868?d=identicon)[prykris](/maintainers/prykris)

---

Top Contributors

[![prykris](https://avatars.githubusercontent.com/u/128478910?v=4)](https://github.com/prykris "prykris (4 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/riidme-php-sdk/health.svg)

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

###  Alternatives

[phpro/http-tools

HTTP tools for developing more consistent HTTP implementations.

28137.8k](/packages/phpro-http-tools)[opensearch-project/opensearch-php

PHP Client for OpenSearch

15224.3M65](/packages/opensearch-project-opensearch-php)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

81733.7k](/packages/flow-php-flow)[laudis/neo4j-php-client

Neo4j-PHP-Client is the most advanced PHP Client for Neo4j

184616.9k31](/packages/laudis-neo4j-php-client)[cognesy/instructor-php

The complete AI toolkit for PHP: unified LLM API, structured outputs, agents, and coding agent control

310107.9k1](/packages/cognesy-instructor-php)

PHPackages © 2026

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