icecave/druid

This package is abandoned and no longer maintained. The author suggests using the ramsey/uuid package instead.

An RFC-4122 compliant library for generating and parsing universally unique identifiers (UUIDs).

1.0.1 2014-11-08 08:34 UTC

Requires

• php: >=5.3
• icecave/isolator: ~2|~3

Requires (Dev)

• icecave/archer: ~1

MIT

• James Harris

• random
• id
• uuid
• guid
• global
• RFC-4122
• universal
• universally
• unique
• identifer
• rfc4122
• 4122

README

This project has been deprecated by the authors. Use ramsey/uuid instead.

Druid is an [RFC-4122] compliant PHP library for generating and parsing universally unique identifiers (UUIDs).

composer require icecave/druid

Examples

Druid provides a generator class for each supported UUID version. UUIDs are created by first instantiating the generator for the desired UUID version, then calling the create() method.

All generator classes implement the UuidGeneratorInterface interface, and produce UUIDs that implement UuidInterface.

Generating UUIDs

Version 1 - Network address and time based identifier

// Not yet implemented.

Version 2 - Network address and time based identifier, with POSIX user information

// Not yet implemented.

Version 3 - Named-based MD5 hash identifer

// Not yet implemented.

Version 4 - Randomly generated identifier

$generator = new Icecave\Druid\UuidVersion4Generator;
$uuid = $generator->generate();

assert($uuid instanceof Icecave\Druid\UuidInterface);

Version 5 - Name-based SHA-1 identifier

// Not yet implemented.

Parsing UUIDs

UUIDs can be constructed from hexadecimal strings and binary buffers using the Uuid::fromString() and Uuid::fromBinary() methods, respectively.

$uuidFromString = Icecave\Druid\Uuid::fromString(
    '550e8400-e29b-41d4-a716-446655440000'
);

$uuidFromBinary = Icecave\Druid\Uuid::fromBinary(
    "\x55\x0e\x84\x00\xe2\x9b\x41\xd4\xa7\x16\x44\x66\x55\x44\x00\x00"
);