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

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

Description

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.

Parameters

$dataarrayrequired
The input array to generate an ID from.
$prefixstringoptional
A prefix to prepend to the generated ID. Default ''.

Default:''

Return

string The generated unique ID for the array.

Source

function wp_unique_id_from_values( array $data, string $prefix = '' ): string {
	if ( empty( $data ) ) {
		_doing_it_wrong(
			__FUNCTION__,
			sprintf(
				/* translators: %s: parameter name. */
				__( 'The %s argument must not be empty.' ),
				'$data'
			),
			'6.8.0'
		);
	}
	$serialized = wp_json_encode( $data );
	$hash       = substr( md5( $serialized ), 0, 8 );
	return $prefix . $hash;
}

Changelog

VersionDescription
6.8.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.