Sonyflake
=========
Class: ``Infocyph\\UID\\Sonyflake``
Bit Layout
----------
Sonyflake uses a 64-bit layout:
- 39 bits elapsed time in 10ms units from custom epoch
- 16 bits machine ID
- 8 bits sequence
Generation
----------
.. code-block:: php
<?php
use Infocyph\UID\Sonyflake;
$id = Sonyflake::generate();
$idFromMachine = Sonyflake::generate(machineId: 42);
Configuration Object
--------------------
Use ``Infocyph\\UID\\Configuration\\SonyflakeConfig`` for:
- fixed or callback-resolved machine ID
- custom epoch
- custom sequence provider
- clock-backward policy
- output type (string/int/binary)
.. code-block:: php
<?php
use Infocyph\UID\Configuration\SonyflakeConfig;
use Infocyph\UID\Sonyflake;
$config = new SonyflakeConfig(machineId: 42);
$id = Sonyflake::generateWithConfig($config);
Validation and Parsing
----------------------
.. code-block:: php
<?php
use Infocyph\UID\Sonyflake;
Sonyflake::isValid($id);
$parsed = Sonyflake::parse($id);
``parse()`` output:
- ``time`` (DateTimeImmutable)
- ``sequence`` (int)
- ``machine_id`` (int)
Custom Epoch APIs
-----------------
- ``Sonyflake::setStartTimeStamp('2020-01-01 00:00:00')``
- ``Sonyflake::parseWithEpoch($id, $epochMs)``
Binary and Alternate Bases
--------------------------
- ``Sonyflake::toBytes($id)`` / ``Sonyflake::fromBytes($bytes)``
- ``Sonyflake::toBase($id, $base)`` / ``Sonyflake::fromBase($encoded, $base)``
Supported bases: ``16``, ``32``, ``36``, ``58``, ``62``.
Exception Types
---------------
- ``Infocyph\\UID\\Exceptions\\SonyflakeException``
- ``Infocyph\\UID\\Exceptions\\FileLockException``
|
Download
