Uuid

Creates a universally unique identifier (UUID) from an array of fields.

Unless you're making advanced use of this library to generate identifiers that deviate from RFC 4122, you probably do not want to instantiate a UUID directly. Use the static methods, instead:

use Ramsey\Uuid\Uuid;

$timeBasedUuid     = Uuid::uuid1();
$namespaceMd5Uuid  = Uuid::uuid3(Uuid::NAMESPACE_URL, 'http://php.net/');
$randomUuid        = Uuid::uuid4();
$namespaceSha1Uuid = Uuid::uuid5(Uuid::NAMESPACE_URL, 'http://php.net/');

Converts this UUID object to a string when the object is used in any string context.

Converts this UUID object to a string when the object is serialized with json_encode()

Converts this UUID object to a string when the object is serialized with serialize()

Re-constructs the object from its serialized form.

Compares this UUID to the specified UUID.

The first of two UUIDs is greater than the second if the most significant field in which the UUIDs differ is greater for the first UUID.

• Q. What's the value of being able to sort UUIDs?
• A. Use them as keys in a B-Tree or similar mapping.

Compares this object to the specified object.

The result is true if and only if the argument is not null, is a UUID object, has the same variant, and contains the same value, bit for bit, as this UUID.

Returns the UUID as a 16-byte string (containing the six integer fields in big-endian byte order).

Returns the high field of the clock sequence multiplexed with the variant (bits 65-72 of the UUID).

Returns the high field of the clock sequence multiplexed with the variant (bits 65-72 of the UUID).

Returns the low field of the clock sequence (bits 73-80 of the UUID).

Returns the low field of the clock sequence (bits 73-80 of the UUID).

Returns the clock sequence value associated with this UUID.

For UUID version 1, the clock sequence is used to help avoid duplicates that could arise when the clock is set backwards in time or if the node ID changes.

For UUID version 3 or 5, the clock sequence is a 14-bit value constructed from a name as described in RFC 4122, Section 4.3.

For UUID version 4, clock sequence is a randomly or pseudo-randomly generated 14-bit value as described in RFC 4122, Section 4.4.

Returns the clock sequence value associated with this UUID.

Returns the number converter to use for converting hex values to/from integers.

Returns a PHP DateTime object representing the timestamp associated with this UUID.

The timestamp value is only meaningful in a time-based UUID, which has version type 1. If this UUID is not a time-based UUID then this method throws UnsupportedOperationException.

Returns an array of the fields of this UUID, with keys named according to the RFC 4122 names for the fields.

• time_low: The low field of the timestamp, an unsigned 32-bit integer
• time_mid: The middle field of the timestamp, an unsigned 16-bit integer
• time_hi_and_version: The high field of the timestamp multiplexed with the version number, an unsigned 16-bit integer
• clock_seq_hi_and_reserved: The high field of the clock sequence multiplexed with the variant, an unsigned 8-bit integer
• clock_seq_low: The low field of the clock sequence, an unsigned 8-bit integer
• node: The spatially unique node identifier, an unsigned 48-bit integer

Returns an array of the fields of this UUID, with keys named according to the RFC 4122 names for the fields.

• time_low: The low field of the timestamp, an unsigned 32-bit integer
• time_mid: The middle field of the timestamp, an unsigned 16-bit integer
• time_hi_and_version: The high field of the timestamp multiplexed with the version number, an unsigned 16-bit integer
• clock_seq_hi_and_reserved: The high field of the clock sequence multiplexed with the variant, an unsigned 8-bit integer
• clock_seq_low: The low field of the clock sequence, an unsigned 8-bit integer
• node: The spatially unique node identifier, an unsigned 48-bit integer

Returns the hexadecimal value of the UUID.

Returns the integer value of the UUID, converted to an appropriate number representation.

Returns the least significant 64 bits of this UUID's 128 bit value.

Returns the least significant 64 bits of this UUID's 128 bit value.

Returns the most significant 64 bits of this UUID's 128 bit value.

Returns the most significant 64 bits of this UUID's 128 bit value.

Returns the node value associated with this UUID

For UUID version 1, the node field consists of an IEEE 802 MAC address, usually the host address. For systems with multiple IEEE 802 addresses, any available one can be used. The lowest addressed octet (octet number 10) contains the global/local bit and the unicast/multicast bit, and is the first octet of the address transmitted on an 802.3 LAN.

For systems with no IEEE address, a randomly or pseudo-randomly generated value may be used; see RFC 4122, Section 4.5. The multicast bit must be set in such addresses, in order that they will never conflict with addresses obtained from network cards.

For UUID version 3 or 5, the node field is a 48-bit value constructed from a name as described in RFC 4122, Section 4.3.

For UUID version 4, the node field is a randomly or pseudo-randomly generated 48-bit value as described in RFC 4122, Section 4.4.

Returns the node value associated with this UUID

For UUID version 1, the node field consists of an IEEE 802 MAC address, usually the host address. For systems with multiple IEEE 802 addresses, any available one can be used. The lowest addressed octet (octet number 10) contains the global/local bit and the unicast/multicast bit, and is the first octet of the address transmitted on an 802.3 LAN.

For systems with no IEEE address, a randomly or pseudo-randomly generated value may be used; see RFC 4122, Section 4.5. The multicast bit must be set in such addresses, in order that they will never conflict with addresses obtained from network cards.

For UUID version 3 or 5, the node field is a 48-bit value constructed from a name as described in RFC 4122, Section 4.3.

For UUID version 4, the node field is a randomly or pseudo-randomly generated 48-bit value as described in RFC 4122, Section 4.4.

Returns the high field of the timestamp multiplexed with the version number (bits 49-64 of the UUID).

Returns the high field of the timestamp multiplexed with the version number (bits 49-64 of the UUID).

Returns the low field of the timestamp (the first 32 bits of the UUID).

Returns the low field of the timestamp (the first 32 bits of the UUID).

Returns the middle field of the timestamp (bits 33-48 of the UUID).

Returns the middle field of the timestamp (bits 33-48 of the UUID).

Returns the timestamp value associated with this UUID.

The 60 bit timestamp value is constructed from the time_low, time_mid, and time_hi fields of this UUID. The resulting timestamp is measured in 100-nanosecond units since midnight, October 15, 1582 UTC.

The timestamp value is only meaningful in a time-based UUID, which has version type 1. If this UUID is not a time-based UUID then this method throws UnsupportedOperationException.

Returns the timestamp value associated with this UUID.

The 60 bit timestamp value is constructed from the time_low, time_mid, and time_hi fields of this UUID. The resulting timestamp is measured in 100-nanosecond units since midnight, October 15, 1582 UTC.

The timestamp value is only meaningful in a time-based UUID, which has version type 1. If this UUID is not a time-based UUID then this method throws UnsupportedOperationException.

Returns the string representation of the UUID as a URN.

Returns the variant number associated with this UUID.

The variant number describes the layout of the UUID. The variant number has the following meaning:

• 0 - Reserved for NCS backward compatibility
• 2 - The RFC 4122 variant (used by this class)
• 6 - Reserved, Microsoft Corporation backward compatibility
• 7 - Reserved for future definition

Returns the version number associated with this UUID.

The version number describes how this UUID was generated and has the following meaning:

• 1 - Time-based UUID
• 2 - DCE security UUID
• 3 - Name-based UUID hashed with MD5
• 4 - Randomly generated UUID
• 5 - Name-based UUID hashed with SHA-1

Returns null if this UUID is not an RFC 4122 variant, since version is only meaningful for this variant.

Converts this UUID into a string representation.

Returns the currently set factory used to create UUIDs.

Sets the factory used to create UUIDs.

Creates a UUID from a byte string.

Creates a UUID from the string standard representation.

Creates a UUID from a 128-bit integer string.

Check if a string is a valid UUID.

Generate a version 1 UUID from a host ID, sequence number, and the current time.

Generate a version 3 UUID based on the MD5 hash of a namespace identifier (which is a UUID) and a name (which is a string).

Generate a version 4 (random) UUID.

Generate a version 5 UUID based on the SHA-1 hash of a namespace identifier (which is a UUID) and a name (which is a string).