robinvdvleuten/ulid

Universally Unique Lexicographically Sortable Identifier (ULID) implementation for PHP.

Maintainers

Details

github.com/robinvdvleuten/php-ulid

Homepage

Source

Issues

Installs: 2 283 859

Dependents: 28

Suggesters: 1

Security: 0

Stars: 443

Watchers: 7

Forks: 34

Open Issues: 5

v5.0.0 2020-12-06 19:13 UTC

Requires

  • php: ^7.2|^8.0

Requires (Dev)

MIT 5389c9a2ff020815cc1f2b840334fdcb84ae3f35

  • Robin van der Vleuten <robin.woop@webstronauts.co>

This package is auto-updated.

Last update: 2024-10-23 13:22:13 UTC

README

Latest Stable Version Build Status

A PHP port of ulid/javascript with some minor improvements.

Sponsored by The Webstronauts

Installation

You can install the package via Composer.

composer require robinvdvleuten/ulid

Usage

use Ulid\Ulid;

$ulid = Ulid::generate();
echo (string) $ulid; // 01B8KYR6G8BC61CE8R6K2T16HY

// Or if you prefer a lowercased output
$ulid = Ulid::generate(true);
echo (string) $ulid; // 01b8kyr6g8bc61ce8r6k2t16hy

// If you need the timestamp from an ULID instance
$ulid = Ulid::generate();
echo $ulid->toTimestamp(); // 1561622862

// You can also generate a ULID for a specific UNIX-time in milliseconds
$ulid = Ulid::fromTimestamp(1593048767015);
// or with a lower cased output: $ulid = Ulid::fromTimestamp(1593048767015, true);
echo (string) $ulid; // 01EBMHP6H7TT1Q4B7CA018K5MQ

Testing

composer test

Changelog

Please see the GitHub "Releases" page for more information on what has changed recently.

Credits

As it's just a simple port of JavaScript to PHP code. All credits should go to the original ULID specs.

License

The MIT License (MIT). Please see License File for more information.