PHPackages                             thejawker/super-random - 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. thejawker/super-random

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

thejawker/super-random
======================

Allows for easy unique code generation, is database aware for Laravel Applications.

v1.0.2(8y ago)027MITPHPPHP >=7.0.0

Since Feb 9Pushed 8y ago1 watchersCompare

[ Source](https://github.com/thejawker/super-random)[ Packagist](https://packagist.org/packages/thejawker/super-random)[ Docs](https://github.com/thejawker/super-random)[ RSS](/packages/thejawker-super-random/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (4)Dependencies (5)Versions (5)Used By (0)

Generate Database Aware Unique Codes For Laravel
================================================

[](#generate-database-aware-unique-codes-for-laravel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/835996b14a67c9f4300aac6b3407c3cfaa919a054663638ca7e3a89e9f9211fc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7468656a61776b65722f73757065722d72616e646f6d2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/thejawker/super-random)[![Build Status](https://camo.githubusercontent.com/f474bcc57fb1dbca3845b09e6e3df835b2232ef13d58506dd589eff5f1084c84/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f7468656a61776b65722f73757065722d72616e646f6d2f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/thejawker/super-random)[![Quality Score](https://camo.githubusercontent.com/ce62835b785a2084bf6da249903dc26be337b16cae42030f4f86a251923f6986/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f7468656a61776b65722f73757065722d72616e646f6d2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/thejawker/super-random)[![Total Downloads](https://camo.githubusercontent.com/dbcac567ea093a13b8a94eec5e7b402e0a3fbf3458f22bb0540bb35f76009130/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7468656a61776b65722f73757065722d72616e646f6d2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/thejawker/super-random)

Nice and fluent way to create truly unique codes or tokens.

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

[](#installation)

Require the package from Composer:

```
composer require thejawker/super-random
```

As of Laravel 5.5 it will magically register the package.

Usage
-----

[](#usage)

Just simple call the generate method on SuperRandom Facade or the handy shortcut helper function.

```
$code = SuperRandom::generate();
echo $code; //

$code = superRandom();
```

### Examples:

[](#examples)

#### Database Aware

[](#database-aware)

Often you don't want more than one of the same codes or tokens to be present in your database. Although it's easy to compare to the database it is annoying having to re-implement this all over the place. By specifying the `table.column` in the `for` method you can easily make it entry aware.

```
ConcertTicket::create([
    'band' => 'DYSSEBIA',
    'code' => SuperRandom::for(ConcertTicket::class)->generate()
]);

// Or more explicit:
ConcertTicket::create([
    'band' => 'DYSSEBIA',
    'code' => SuperRandom::for('concerts.code')->generate()
]);
```

### Length

[](#length)

You can specify the length as follows:

```
ConcertTicket::create([
    'band' => 'DYSSEBIA',
    'code' => SuperRandom::length(12)->generate()
]);
```

### Allowed Chars

[](#allowed-chars)

You can specify the allowed chars as follows:

```
ConcertTicket::create([
    'band' => 'DYSSEBIA',
    'code' => SuperRandom::chars('abc123')->generate()
]);
```

By default we only include numbers and UPPERCASE characters with the exclusion of: `1, I, O, 0` since they look a lot alike and you don't want your users to guess.

### Full Config

[](#full-config)

You can alternatively set the config right on the `generate()` method.

```
ConcertTicket::create([
    'band' => 'DYSSEBIA',
    'code' => SuperRandom::generate([
        'table' => 'concerts',
        'column' => 'code',
        'length' => 15,
        'chars' => 'abc123'
    ])
]);
```

Test
----

[](#test)

```
composer test
```

License
-------

[](#license)

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

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity61

Established project with proven stability

 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

Every ~3 days

Total

4

Last Release

3053d ago

Major Versions

v0.0.1 → v1.0.02018-02-12

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6703837?v=4)[Bram Veerman](/maintainers/thejawker)[@thejawker](https://github.com/thejawker)

---

Top Contributors

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

---

Tags

randomcode generatoruniquetoken generatorthejawkerdatabase-aware-unique-code-generator

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/thejawker-super-random/health.svg)

```
[![Health](https://phpackages.com/badges/thejawker-super-random/health.svg)](https://phpackages.com/packages/thejawker-super-random)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3345.1M337](/packages/psalm-plugin-laravel)[aedart/athenaeum

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

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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