Generating UUIDs in PHP

UUID version 4 identifiers encode 122 random bits with fixed version and variant fields.

What It Does

UUID version 4 identifiers encode 122 random bits with fixed version and variant fields. The following examples distinguish a normal use case, a boundary case and a practical application.

Requirements and Compatibility

PHP 8.x and a local test environment. Apply input validation, correct error handling and the requirements of any optional libraries.

The code focuses on the core concept. Production implementation may also need routes, validation, persistence, authorization or deployment tooling.

Example 1: Basic Behavior

Understand the primary operation and its inputs.

<?php
$bytes = random_bytes(16);
$bytes[6] = chr((ord($bytes[6]) & 0x0f) | 0x40);
$bytes[8] = chr((ord($bytes[8]) & 0x3f) | 0x80);
$hex = bin2hex($bytes);
echo vsprintf('%s%s-%s-%s-%s-%s', str_split($hex, 4));

Example 2: Another Case

Check failure behavior or a different execution path.

<?php
$hex = bin2hex(random_bytes(16));
echo strlen($hex) === 32 ? '128 random bits' : 'Unexpected length'; // Raw random hex is not a versioned UUID

Practical Example: Putting It to Use

Apply the behavior in a small, controlled scenario.

<?php
$uuid = '550e8400-e29b-41d4-a716-446655440000';
echo preg_match('/^[a-f0-9]{8}(-[a-f0-9]{4}){3}-[a-f0-9]{12}$/Di', $uuid) ? 'Well-formed pattern' : 'Malformed';

Important Behavior and Edge Cases

A random hex string is not automatically an RFC-compliant UUID; identifiers are not authorization tokens.

Comparison with Related Functions or Approaches

Common Beginner Mistakes

Key Takeaways

• UUID version 4 identifiers encode 122 random bits with fixed version and variant fields.
• A random hex string is not automatically an RFC-compliant UUID; identifiers are not authorization tokens.
• Use random_bytes() or a maintained UUID package.

Before adapting these examples, verify the return values, test the failure paths and confirm that your application meets its security and environment requirements.