Changeset 60131

Timestamp:

04/05/2025 09:04:52 PM (18 months ago)

Author:

SergeyBiryukov

Message:

Coding Standards: Move wp_unique_id_from_values() next to wp_unique_id() and wp_unique_prefixed_id(), for consistency.

Follow-up to [60038].

See #63168.

File:

• trunk/src/wp-includes/functions.php (modified) (2 diffs)

trunk/src/wp-includes/functions.php

@@ -8031 +8031 @@
 
 /**
+ * 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.
+ *
+ * @since 6.8.0
+ *
+ * @param array  $data   The input array to generate an ID from.
+ * @param string $prefix Optional. A prefix to prepend to the generated ID. Default empty string.
+ * @return string The generated unique ID for the array.
+ */
+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;
+}
+
+/**
  * Gets last changed date for the specified cache group.
  *
@@ -9174 +9206 @@
         return hash_equals( $hash, wp_fast_hash( $message ) );
 }
-
-/**
- * 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.
- *
- * @since 6.8.0
- *
- * @param array  $data   The input array to generate an ID from.
- * @param string $prefix Optional. A prefix to prepend to the generated ID. Default ''.
- *
- * @return string The generated unique ID for the array.
- */
-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;
-}