# ramsey/uuid

:snowflake: A PHP library for generating universally unique identifiers (UUIDs).

Repository: https://github.com/ramsey/uuid
Canonical: https://ross.abutalabs.com/products/ramsey-uuid
Homepage: https://uuid.ramsey.dev
Language: PHP
License: MIT
License Family: permissive
Topics: uuid, guid, identifiers, php, php8, uid
Last push: 2026-07-04T19:20:59+00:00

## Health v2 (maintenance only)
Score: 87/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 90, release rhythm 77, longevity 100
- inputs: {"age_days": 5172, "days_push": 60, "days_rel": 76, "gap_med": 70, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 12633, forks 527 (observed 2026-08-28T04:10:59.459461+00:00)

## What it is
ramsey/uuid is a PHP library for generating and working with universally unique identifiers (UUIDs) conforming to RFC 9562 (formerly RFC 4122). It supports all standard UUID versions (1-8), GUIDs, and nonstandard formats, with customization options for codecs, validators, and factories.

## Use cases
- generate uuids in php
- create rfc 9562 compliant unique identifiers
- generate uuid v7 for database primary keys
- parse and validate uuid strings in php
- generate name-based md5 or sha1 uuids
- store uuids as bytes or strings in a database
- mock uuids for testing php applications

## When to choose
- you need standards-compliant UUID generation in a PHP 8+ project
- you need sortable time-ordered UUIDs (v6/v7) for database keys
- you need to work with GUIDs or nonstandard UUID variants
- you want a mature, widely-used PHP UUID library with active maintenance

## When to avoid
- your project is not written in PHP
- you only need simple random IDs and don't require UUID semantics
- you need UUID generation in another language's native runtime without FFI

## Facets
- artifact type: library
- maturity: stable
- function: serialization, developer-tools
- domain: developer-tools, databases, web-development
- platform: php, cross-platform
- tags: uuid, guid, rfc-9562, identifiers, composer

## Member repositories
- ramsey/uuid (main) score 87

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:59.459461+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:13:54.630137+00:00, confidence not recorded.
  - readme: https://github.com/ramsey/uuid (fetched 2026-08-28T04:10:59.459461+00:00, sha 3f48147ff59b)
  - homepage: https://uuid.ramsey.dev (fetched 2026-08-29T08:10:19.015984+00:00, sha 58bbac1bec28)
  - site_page: https://uuid.ramsey.dev/en/stable/quickstart.html (fetched 2026-08-29T08:10:19.025109+00:00, sha 5c8e2a4720c0)
  - site_page: https://uuid.ramsey.dev/en/stable/faq.html (fetched 2026-08-29T08:10:19.027257+00:00, sha 949a93e39dd2)
- Data as of 2026-08-30T08:39:29.467469+00:00.