WP_UNIQUE_ID() │ WP 5.0.3

Функция WP_UNIQUE_ID() генерирует уникальный идентификатор.

Что это такое?

Это реализация функции uniqueId из библиотеки Underscore. Внутри функции используется статическая переменная, которая хранит целое число и увеличивается при каждом вызове. Полученное число возвращается вместе с опциональным префиксом. Это означает, что возвращаемое значение не является уникальным на все времена, но уникально в пределах одного выполнения PHP-скрипта.

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

• Тип: строка (string)
• Описание: Уникальный идентификатор.

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

Для генерации уникального ID используется следующая запись:

wp_unique_id( $prefix );

• $prefix (string) — префикс для возвращаемого идентификатора. По умолчанию: '' (пустая строка).

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

Рассмотрим несколько примеров, чтобы понять, как работает функция:

Пример 1: Работа функции

echo wp_unique_id();            //> 5 (вероятно, функция уже вызывалась ранее, так что получить 1 маловероятно)
echo wp_unique_id();            //> 6
echo wp_unique_id( 'field_' );  //> field_7
echo wp_unique_id();            //> 8
echo wp_unique_id();            //> 9
echo wp_unique_id( 'name_' );   //> name_10
echo wp_unique_id();            //> 11
echo wp_unique_id();            //> 12

Пример 2: Создание уникальных ID для привязки меток и полей ввода

// Генерируем уникальный идентификатор
$unique_id = wp_unique_id( 'field_' );

// Выводим HTML
echo sprintf( 'Введите текст:', $unique_id );
echo sprintf( '', $unique_id );

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

Изменения

• С версии 5.0.3: Функция была введена в WordPress.

Код функции

Вот как выглядит код самой функции:

function wp_unique_id( $prefix = '' ) {
static $id_counter = 0;
return $prefix . (string) ++$id_counter;
}

Связанные функции

Вот несколько вспомогательных функций, которые могут быть полезны:

• __return_empty_array()
• __return_empty_string()
• __return_false()
• __return_null()
• __return_true()
• __return_zero()
• array_key_first()
• array_key_last()

Эти функции могут помочь вам в различных задачах при разработке на WordPress.

Эта статья предоставляет понятное и детальное объяснение функции WP_UNIQUE_ID(), которое подходит даже для начинающих пользователей.