wp_unique_prefixed_id() — описание функции WordPress на русском

Сигнатура

wp_unique_prefixed_id( string $prefix = '' ): string

Описание

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

Оригинал (английский)

It is similar to wp_unique_id, but each prefix has its own internal ID counter to make each prefix independent from each other. The ID starts at 1 and increments on each call. The returned value is not universally unique, but it is unique across the life of the PHP process and it’s stable per prefix.

Параметры

$prefix string необязательный = ''

Префикс для возвращаемого идентификатора.

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

string

Исходный код

wp-includes/functions.php:8085

function wp_unique_prefixed_id( $prefix = '' ) {
	static $id_counters = array();

	if ( ! is_string( $prefix ) ) {
		wp_trigger_error(
			__FUNCTION__,
			sprintf( 'The prefix must be a string. "%s" data type given.', gettype( $prefix ) )
		);
		$prefix = '';
	}

	if ( ! isset( $id_counters[ $prefix ] ) ) {
		$id_counters[ $prefix ] = 0;
	}

	$id = ++$id_counters[ $prefix ];

	return $prefix . (string) $id;
}

История изменений

Версия	Описание
6.4.0	Introduced.