keiko / uuid-shortener
A simple shortener library for RFC 4122 compatible UUIDs. Change your 36 chars long UUID into it's shorter equivalent.
Installs: 161 982
Dependents: 2
Suggesters: 1
Security: 0
Stars: 146
Watchers: 6
Forks: 6
Open Issues: 1
Requires
- php: ^8.1
- brick/math: ^0.11 || ^0.12
Requires (Dev)
- ext-gmp: ^8.1
- php-cs-fixer/shim: ^3.41
- phpbench/phpbench: ^1.1.1
- phpunit/phpunit: ^8.5.26
- rector/rector: ^0.18.12
- vimeo/psalm: ^4.3.1
Suggests
- ext-gmp: If you want to use the Keiko\Uuid\Shortener\GMPShortener and benefit from much improved performance
- ramsey/uuid: A PHP 5.4+ library for generating RFC 4122 version 1, 3, 4, and 5 universally unique identifiers (UUID)
README
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.
Installation
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
Example
<?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
Performance
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.
Plans
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.