bulldog / id
ID Generator
Requires
- php: ^7.1
Requires (Dev)
- phpunit/phpunit: ^7.5@dev
- symfony/var-dumper: ^4.2@dev
This package is auto-updated.
Last update: 2024-12-12 09:09:19 UTC
README
A library for generating IDs.
Object ID
If your Object ID is long enough, it can be generated on multiple systems, without worrying about a collision. Using time-based buckets gives us locality for each new ID.
The first half of the ID is a bucket. The bucket is the difference between two unix timestamps. The first timestamp is the beginning of the current year, and the second timestamp is when the method is called. This is more efficient than only using the current timestamp. We will end up with more buckets this way.
The second half of the ID uses the random_bytes function. It is then safely
encoded using base 64. We strip away any characters that are unsafe for URLs.
Usage
The example below generates 5,000 Object IDs.
<?php require 'vendor/autoload.php'; use Bulldog\id\ObjectId; $id = new ObjectId; for($i=0; $i<5000; $i++) { var_dump($id->get(12)); }
Incremental ID
You can use multiple IDs to create a base64 encoded incremental ID. You may want to use the user's ID and another primary key from a relational database to create a unique incremental ID.
Usage
The example below will generate the same string each time.
<?php require 'vendor/autoload.php'; use Bulldog\id\IncrementalId; $id = new IncrementalId; var_dump($id->create(4, 'dog', 9)); // Output: NAZG9nOQ var_dump($id->get(4)); // Output: NAZG