Stars: 120
Forks: 6
Pull Requests: 19
Issues: 4
Watchers: 5
Last Updated: 2023-02-02 08:05:22
A simple RFC 4122 UUID shortener library. Change your 36 chars long ID into it's shorter equivalent.
License: MIT License
Languages: PHP
A simple shortener library for RFC 4122 compatible UUIDs. Change your 36 chars long UUID into it's shorter equivalent.
Key concept and inspiration taken from pascaldevink/shortuuid library.
If you just need to generate short UUIDs the easy way, I encourage you to check his work.
If you expect perfomance, this library uses ext-gmp
to speed up the process.
The preferred method of installation is via Packagist and Composer. Run the following command to install the package and add it as a requirement to your project's composer.json:
composer require keiko/uuid-shortener
<?php
require 'vendor/autoload.php';
use Keiko\Uuid\Shortener\Dictionary;
use Keiko\Uuid\Shortener\Shortener;
// Generate UUID, for example using Ramsey/UUID
$uuid = '806d0969-95b3-433b-976f-774611fdacbb';
$shortener = Shortener::make(
Dictionary::createUnmistakable() // or pass your own characters set
);
echo $shortener->reduce($uuid); // output: mavTAjNm4NVztDwh4gdSrQ
You can reverse the process and expand your short UUID back to hexadecimal value.
<?php
require 'vendor/autoload.php';
use Keiko\Uuid\Shortener\Dictionary;
use Keiko\Uuid\Shortener\Shortener;
$shortUuid = 'mavTAjNm4NVztDwh4gdSrQ';
$shortener = Shortener::make(
Dictionary::createUnmistakable()
);
echo $shortener->expand($shortUuid); // output: 806d0969-95b3-433b-976f-774611fdacbb
In order to get optimal performance from this library, it is endorsed that you run ext-gmp
in your system.
Keiko\Uuid\Shortener\Shortener::make()
will pick a GMP-compatible shortener or a fallback
shortener based on your system dependencies.
UUID Shortener is not connected with any UUID generator library. It also does not generate new UUIDs. It has only one purpose - transform your long, hexadecimal IDs (no matter where they come from), into a shorter and easier to read set of characters. In the near future additional service will be added, which will be able to generate short UUIDs in companion with most popular UUID generators.