vlw/scaffold
1
0
Fork 0
mirror of https://codeberg.org/vlw/scaffold.git synced 2026-01-11 22:16:00 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

feat: add UUID v7 generator helper method (#17)

Browse source 
This PR adds a `UUID::v7()` method for generating version 7 UUIDs, which have several performace advantages over v4 when stored in database indecies.

Reviewed-on: https://codeberg.org/vlw/scaffold/pulls/17
This commit is contained in:
Victor Westerlund 2025-12-03 00:48:13 +01:00
parent be03b05191
commit d9726aff0e
1 changed files with 48 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

48
src/Helpers/UUID.php
View file

@ -26,6 +26,54 @@
return "FFFFFFFF-FFFF-FFFF-FFFF-FFFFFFFFFFFF";
}
/**
* Generate a version 7 UUID
*
* @return string
*/
function v7(): string {
static $last_unix_epoch = null;
static $sequence = 0;
// Get current time in milliseconds
$unix_ms = (int) microtime(true) * 1000;
// Compensate for same-ms collisions
if ($unix_ms === $last_unix_epoch) {
$sequence++;
// Keep within the 14-bit sequence range
$sequence &= 0x3FFF;
// Bump time slightly to avoid collision
if ($sequence === 0) {
$unix_ms++;
}
} else {
// Random start per ms
$sequence = random_int(0, 0x3FFF);
$last_unix_epoch = $unix_ms;
}
$time_high = ($unix_ms >> 16) & 0xFFFFFFFF;
$time_low = $unix_ms & 0xFFFF;
$time_hi_and_version = ($time_low & 0x0FFF) | (0x7 << 12);
$clock_seq_hi_and_reserved = ($sequence & 0x3FFF) | 0x8000;
// Generate 6 bytes (48 bits) of randomness
$rand_bytes = random_bytes(6);
$rand_hex = bin2hex($rand_bytes);
return sprintf(
"%08x-%04x-%04x-%04x-%012s",
$time_high,
$time_low,
$time_hi_and_version,
$clock_seq_hi_and_reserved,
$rand_hex
);
}
/**
* Generate a version 4 UUID
*