Download the PHP package artnum/snowflake53 without Composer
On this page you can find all versions of the php package artnum/snowflake53. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download artnum/snowflake53
More information about artnum/snowflake53
Files in artnum/snowflake53
Package snowflake53
Short Description Generate unique 53 bits snowflake IDs
License MIT
Informations about the package snowflake53
Snowflake53
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 :
Usage
All functions are declared as static, so it is possible to use without a class instance.
You can destroy, if you choose to, shared memory semgent and semaphore by calling
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.
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 [email protected]