Changeset 60131

Timestamp:

04/05/2025 09:04:52 PM (3 weeks 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;
-}