WP_GENERATE_UUID4() │ WP 4.7.0

Функция WP_GENERATE_UUID4() создает уникальный идентификатор — случайную строку, состоящую из букв и цифр. Она создает UUID (универсальный уникальный идентификатор) версии 4.

Как это работает

Функция использует восемь функций mt_rand() и имеет формат:

%04x%04x-%04x-%04x-%04x-%04x%04x%04x%04x

Это значит, что UUID состоит из 5 частей:

• Часть 1: 8 символов.
• Части 2, 3, 4: по 4 символа каждая, все разные.
• Часть 5: 12 символов.

Пример UUID

4c585b5e-5220-4b1d-92e2-316f88210482

Объяснение UUID

UUID представляет собой 128-битное значение (16 байт). Он содержит четыре 4-байтных числа, которые записаны в шестнадцатеричном формате и разделены символами -. Общая длина UUID — 36 символов.

• Символы '-' располагаются после 4-го, 6-го, 8-го байтов и после 10-го байта.
• Поскольку UUID является шестнадцатеричным значением, его следует рассматривать как нечувствительное к регистру: 11223344-5566-7788-99AA-BBCCDDEEFF00 считается таким же, как 11223344-5566-7788-99aa-bbccddeeff00.

Важно: Эта функция всегда возвращает строку в нижнем регистре.

Преобразование UUID

Если вам нужно получить строку длиной 32 символа (такую же, как у MD5), можете использовать следующий код:

$uuid36 = wp_generate_uuid4(); // Пример: a938e855-483e-48c7-9b98-f41e90511f77
$uuid32 = str_replace( '-', '', $uuid36 ); // Пример без дефисов: a938e855483e48c79b98f41e90511f77

Чтобы проверить, является ли строка кодом UUID, используйте функцию wp_is_uuid().

Если вам нужно упрощенное значение UUID, воспользуйтесь стандартной функцией PHP uniqid().

Производительность

• Время выполнения функции один раз: 0 секунд (скорость света).
• 50000 раз: 0.07 секунд (скорость света).

Результат

Функция возвращает строку — UUID.

Использование

Чтобы сгенерировать UUID, используйте:

wp_generate_uuid4();

Примеры использования

Простой пример

echo wp_generate_uuid4();
//> Пример выхода: 9d9c81fc-4233-4b6e-98aa-b553d7d200ab

Изменения

• С версии 4.7.0 функция была представлена в WordPress.

Код функции

Вот как выглядит реализация функции wp_generate_uuid4() в файле functions.php:

function wp_generate_uuid4() {
return sprintf(
'%04x%04x-%04x-%04x-%04x-%04x%04x%04x',
mt_rand( 0, 0xffff ),
mt_rand( 0, 0xffff ),
mt_rand( 0, 0xffff ),
mt_rand( 0, 0x0fff ) | 0x4000,
mt_rand( 0, 0x3fff ) | 0x8000,
mt_rand( 0, 0xffff ),
mt_rand( 0, 0xffff ),
mt_rand( 0, 0xffff )
);
}

Теперь вы знаете, что такое UUID и как использовать функцию wp_generate_uuid4() в WordPress. Надеюсь, эта информация была для вас полезной!