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

Сигнатура

wp_unique_id_from_values( array $data, string $prefix = '' ): string

Описание

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

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

This function serializes the array into a JSON string and generates a hash that serves as a unique identifier. Optionally, a prefix can be added to the generated ID for context or categorization.

Параметры

$data array обязательный

Входной массив, на основе которого генерируется ID.

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

Префикс, добавляемый в начало сгенерированного ID.

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

string

Исходный код

wp-includes/functions.php:8118

function wp_unique_id_from_values( array $data, string $prefix = '' ): string {
	if ( empty( $data ) ) {
		_doing_it_wrong(
			__FUNCTION__,
			sprintf(
				/* translators: %s: The parameter name. */
				__( 'The %s parameter must not be empty.' ),
				'$data'
			),
			'6.8.0'
		);
	}

	$serialized = wp_json_encode( $data );
	$hash       = substr( md5( $serialized ), 0, 8 );

	return $prefix . $hash;
}

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

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