README

A trait to generate 53 bits snowflake id to fit into js Number.MAX_SAFE_INTEGER. Sequence counting is done with shared memory and machine ID comes from environment variable or parameters It also possible to generate 64 bits snowflake id.

It dosen't require any external infrastructure (like Memcached or Redis or ...) to keep sequence counting as it is done by shared memory and use semaphore for locking. So other processes can tap into the sequence counting too :)

Install

Via composer :

$ composer require artnum/snowflake53

Usage

require_once 'vendor/autoload.php';

use Snowflake53\ID;

class IDGen {
    use ID;
}

$gen = new IDGen();
echo $gen->get53() . PHP_EOL;
echo $gen->get64() . PHP_EOL;

All functions are declared as static, so it is possible to use without a class instance.

require_once 'vendor/autoload.php';

use Snowflake53\ID;

class IDGen {
    use ID;
}

echo IDGen::get53() . PHP_EOL;
echo IDGen::get64() . PHP_EOL;

You can destroy, if you choose to, shared memory semgent and semaphore by calling destroySHM:

require_once 'vendor/autoload.php';

use Snowflake53\ID;

class IDGen {
    use ID;
}

IDGen::destroySHM(); 

Shared memory path

Shared memory use a file path as identity. By default it is __FILE__. But if you use this in several different places on your server but still want all ID to be in sequence, you can set the public static variable $SHMPath to the path you want. The file must exist.

require_once 'src/Snowflake53.php';

use Snowflake53\ID;

class IDGen {
    use ID;
}

IDGen::$SHMPath = '/tmp/snowflake53';
echo IDGen::get53() . PHP_EOL;
echo IDGen::get64() . PHP_EOL;


$gen = new IDGen();
$gen::$SHMPath = '/tmp/snowflake53';
echo $gen->get53() . PHP_EOL;
echo $gen->get64() . PHP_EOL;

Machine ID

Machine ID can be passed as argument of get53 or get64. If not, it will try to get the ID from environment variable SNOWFLAK53_MACHINE_ID, SNOWFLAKE64_MACHINE_ID or SNOWFLAKE_MACHINE_ID. When getting a 53 bits ID, SNOWFLAK53_MACHINE_ID will be look at and then SNOWFLAKE_MACHINE_ID, when getting a 64 bits ID it's the opposite (first SNOWFLAKE64_MACHINE_ID and then SNOWFLAKE_MACHINE_ID).

The idea behind that is you set a unique machine for 64 and 53 bits and so, you use SNOWFLAKE_MACHINE_ID or you have a different machine ID for 53 bits or 64 bits and so you set SNOWFLAKE53_MACHINE_ID and SNOWFLAKE64_MACHINE_ID.

License

Under MIT license.

Developer

• Etienne Bagnoud etienne@artnum.ch