Ordinary UID is a simple solution for generating universally unique ids.
Install using composer.
composer require ordinary/uidUsing the generator
require_once 'vendor/autoload.php';
$randomizer = new \Random\Randomizer(new \Random\Engine\Secure());
$clock = new \Ordinary\Clock\UTCClock();
$generator = new \Ordinary\UID\Generator($clock, $randomizer);
var_dump($generator->generate(4));
var_dump($generator->generateCustom('external-id-1'))IDs generated are considered to be universally unique with the assumption that no two machines will generate a UID at the exact same time with the exact same random bytes.
The first part is a hexadecimal representation of the timestamp from which it was created. The second part is also a hexadecimal representation of the fractional time of the timestamp from which it was created
With the first two parts being representations of time, UIDs can be easily sorted by creation time, by sorting them by their string value. Additionally, if UID is generated using a custom value for custom bytes, the custom bytes portion will be sortable as well, as long as the custom value would have been sortable.
- Time precision can be customized to use millisecond, microsecond, or nanosecond granularity.
- Microsecond granularity is default (1,000,000 UIDs per second)
The last part contains bytes converted to a hexadecimal (Max: 15). This can be used to add a custom identifier, or to add additional uniqueness to the ID.
Get the string value of a UID instance.
Get a DateTimeImmutable instance of the UID.
Get the timestamp in seconds of the UID.
Get the fraction of a second in units determined by the precision.
Get the precision used to create the UID.
Get the custom bytes of the UID.
Generate an Ordinary UID with a given number of random bytes.
Generate an Ordinary UID with the given bytes. $custom can be any string as long as the number of bytes is between 1 and 15.