wp_unique_id_from_values() │ WP 6.8.0

Generates a unique ID based on the structure and values of a given array.

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.

No Hooks.

Returns

String. The generated unique ID for the array.

Usage

wp_unique_id_from_values( $data, $prefix ): string;

$data(array) (required)

The input array to generate an ID from.

$prefix(string)

A prefix to prepend to the generated ID.
Default: empty string

Changelog

wp_unique_id_from_values() wp unique id from values code ^{WP 7.0}

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;
}