Функция wp_generate_uuid4() в WordPress

Функция wp_generate_uuid4() в WordPress используется для генерации UUID версии 4. Этот UUID представляет собой 128-битное значение, которое форматируется как строка длиной 36 символов, включающая тире.

UUID (Universally Unique Identifier) — это уникальный идентификатор, который используется для уникальной идентификации объектов в компьютерных системах. UUID версии 4 генерируется случайным образом и состоит из букв и цифр. Он полезен для создания уникальных идентификаторов для записей в базе данных, транзакций и других элементов.

wp_generate_uuid4();

Возвращаемое значение

Функция возвращает строку, содержащую UUID версии 4 в нижнем регистре.

Объяснение UUID

UUID версии 4 состоит из 128-битного значения (16 байт), представленного в шестнадцатеричной нотации и разделенного на 5 частей:

1. Первая часть состоит из 8 символов.
2. Вторая, третья и четвертая части состоят из 4 символов каждая.
3. Пятая часть состоит из 12 символов.

Формат UUID версии 4:

xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx

Например:

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

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

Функция всегда возвращает UUID в нижнем регистре. Чтобы получить строку длиной 32 символа (аналогично MD5), можно использовать следующее преобразование:

$uuid36 = wp_generate_uuid4(); // a938e855-483e-48c7-9b98-f41e90511f77
$uuid32 = str_replace( '-', '', $uuid36 ); // a938e855483e48c79b98f41e90511f77

Проверка UUID

Для проверки, является ли строка UUID, можно использовать функцию wp_is_uuid().

Использование упрощенной функции UUID

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

uniq_id = uniqid(); // Пример: 5f8f8c7f8c7f8

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

Предположим мы программно добавляем новый пост в базу, и хотим для него так же создать уникальный идентификатор.

// Создаем или обновляем запись и генерируем UUID
$post_id = wp_insert_post( array(
    'post_title'  => 'Пример записи',
    'post_content'=> 'Содержание записи',
    'post_status' => 'publish',
    'post_type'   => 'post',
) );

if ( ! is_wp_error( $post_id ) ) {
    $uuid = wp_generate_uuid4();
    update_post_meta( $post_id, '_custom_uuid', $uuid );
    echo 'Уникальный идентификатор для записи: ' . $uuid;
} else {
    echo 'Ошибка при создании записи: ' . $post_id->get_error_message();
}

Заключение

Функция wp_generate_uuid4() является мощным инструментом для генерации уникальных идентификаторов в WordPress. Она может быть использована в различных сценариях, где требуется уникальная идентификация объектов.