tuupola/ulid

Universally Unique Lexicographically Sortable Identifier

[WIP] PHP ULID

This library implements the Universally Unique Lexicographically Sortable Identifier from Alizain Feerasta., _(*1)

, _(*2)

Install

Install with composer., _(*3)

``` bash $ composer require tuupola/ulid, <sub>(*4)</sub>

## Usage

``` php
use Tuupola\Ulid;

$ulid = new Ulid;

print $ulid; /* 0001DD70YKYBES1P98DHWKTWZW */

//$ulid = ulid::fromString("0o5Fs0EELR0fUjHjbCnEtdUwQe3");

print $ulid->timestamp(); /* 1523811283 */
print bin2hex($ulid->payload()); /* f2dd90d9286c793d73fc */

$datetime = (new \DateTimeImmutable)
    ->setTimestamp($ulid->unixtime())
    ->setTimeZone(new \DateTimeZone("UTC"));

print $datetime->format("Y-m-d H:i:s"); /* 2018-04-15 16:54:43 */

Testing

You can run tests either manually or automatically on every code change. Automatic tests require entr to work., <sub>(*5)</sub>

``` bash $ composer test, <sub>(*6)</sub>

``` bash
$ brew install entr
$ composer watch

Contributing

Please see CONTRIBUTING for details., <sub>(*7)</sub>

Security

If you discover any security related issues, please email tuupola@appelsiini.net instead of using the issue tracker., <sub>(*8)</sub>

License

The MIT License (MIT). Please see License File for more information., <sub>(*9)</sub>