introduction.rst 981 B

12345678910111213141516171819202122232425262728293031
  1. .. _introduction:
  2. ============
  3. Introduction
  4. ============
  5. ramsey/uuid is a PHP library for generating and working with `RFC 4122`_ version
  6. 1, 2, 3, 4, 5, 6, and 7 universally unique identifiers (UUID). ramsey/uuid also
  7. supports optional and non-standard features, such as GUIDs and other approaches
  8. for encoding/decoding UUIDs.
  9. What Is a UUID?
  10. ###############
  11. A universally unique identifier, or UUID, is a 128-bit unsigned integer, usually
  12. represented as a hexadecimal string split into five groups with dashes. The most
  13. widely-known and used types of UUIDs are defined by `RFC 4122`_.
  14. A UUID, when encoded in hexadecimal string format, looks like:
  15. .. code-block:: text
  16. ebb5c735-0308-4e3c-9aea-8a270aebfe15
  17. The probability of duplicating a UUID is close to zero, so they are a great
  18. choice for generating unique identifiers in distributed systems.
  19. UUIDs can also be stored in binary format, as a string of 16 bytes.
  20. .. _RFC 4122: https://tools.ietf.org/html/rfc4122