ramsey/uuid User Guide

For ramsey/uuid stable. Updated on 2026-09-16.

Contents

• Introduction
  • What Is a UUID?
• Getting Started
  • Requirements
  • Install With Composer
  • Using ramsey/uuid
• RFC 9562 (formerly RFC 4122) UUIDs
  • Version 1: Gregorian Time
  • Version 2: DCE Security
  • Version 3: Name-based (MD5)
  • Version 4: Random
  • Version 5: Name-based (SHA-1)
  • Version 6: Reordered Gregorian Time
  • Version 7: Unix Epoch Time
  • Version 8: Custom Format
• Nonstandard UUIDs
  • Version 6: Reordered Gregorian Time
  • Globally Unique Identifiers (GUIDs)
  • Other Nonstandard UUIDs
• Using In a Database
  • Storing As a String
  • Storing As Bytes
  • Using As a Primary Key
  • Using As a Unique Key
  • Insertion Order and Sorting
• Customization
  • Ordered-time Codec
  • Timestamp-first COMB Codec
  • Using a Custom Calculator
  • Using a Custom Validator
  • Replace the Default Factory
• Testing With UUIDs
  • Inject a UUID of a Specific Type
  • Returning Specific UUIDs From a Static Method
  • Mocking UuidInterface
• Upgrading ramsey/uuid
  • Version 3 to 4
  • Version 2 to 3
• FAQs
  • How do I fix “rhumsaa/uuid is abandoned” messages?
  • Why does ramsey/uuid use final?
• Reference
  • Uuid
  • UuidInterface
  • Fields\FieldsInterface
  • Rfc4122\UuidInterface
  • Rfc4122\FieldsInterface
  • Rfc4122\UuidV1
  • Rfc4122\UuidV2
  • Rfc4122\UuidV3
  • Rfc4122\UuidV4
  • Rfc4122\UuidV5
  • Rfc4122\UuidV6
  • Rfc4122\UuidV7
  • Rfc4122\UuidV8
  • Guid\Fields
  • Guid\Guid
  • Nonstandard\Fields
  • Nonstandard\Uuid
  • Nonstandard\UuidV6
  • UuidFactoryInterface
  • Types
  • Exceptions
  • Helper Functions
  • Predefined Namespaces
  • Calculators
  • Validators
• Copyright

Indices and Tables

• Index

• Search Page