Cache: Add wp_cache_*_multiple functions.

Add new caching functions named `wp_cache_add_multiple`, `wp_cache_set_multiple` and `wp_cache_delete_multiple`. All of these functions allow for an array of data to be passed, so that multiple cache objects can be created / edited / deleted in a single function call. This follows on from [47938] where the `wp_cache_get_multiple` function was introduced and allowed for multiple cache objects to be received in one call. 

Props: spacedmonkey, tillkruess, adamsilverstein, flixos90, mitogh, pbearne. 
Fixes: #54574.


git-svn-id: https://develop.svn.wordpress.org/trunk@52700 602fd350-edb4-49c9-b593-d223f7449a82

src/wp-includes/cache-compat.php

@@ -35,3 +35,86 @@ if ( ! function_exists( 'wp_cache_get_multiple' ) ) :
 		return $values;
 	}
 endif;
+
+if ( ! function_exists( 'wp_cache_delete_multiple' ) ) :
+	/**
+	 * Delete multiple values from the cache in one call.
+	 *
+	 * Compat function to mimic wp_cache_delete_multiple().
+	 *
+	 * @ignore
+	 * @since 6.0.0
+	 *
+	 * @see wp_cache_delete_multiple()
+	 *
+	 * @param array  $keys  Array of keys under which the cache to deleted.
+	 * @param string $group Optional. Where the cache contents are grouped. Default empty.
+	 * @return array Array of return values.
+	 */
+	function wp_cache_delete_multiple( array $keys, $group = '' ) {
+		$values = array();
+
+		foreach ( $keys as $key ) {
+			$values[ $key ] = wp_cache_delete( $key, $group );
+		}
+
+		return $values;
+	}
+endif;
+
+
+if ( ! function_exists( 'wp_cache_add_multiple' ) ) :
+	/**
+	 * Add multiple values to the cache in one call, if the cache keys doesn't already exist.
+	 *
+	 * Compat function to mimic wp_cache_add_multiple().
+	 *
+	 * @ignore
+	 * @since 6.0.0
+	 *
+	 * @see wp_cache_add_multiple()
+	 *
+	 * @param array  $data  Array of key and value to be added.
+	 * @param string $group Optional. Where the cache contents are grouped. Default empty.
+	 * @param int    $expire Optional. When to expire the cache contents, in seconds. Default 0 (no expiration).
+	 * @return array Array of return values.
+	 */
+	function wp_cache_add_multiple( array $data, $group = '', $expire = 0 ) {
+		$values = array();
+
+		foreach ( $data as $key => $value ) {
+			$values[ $key ] = wp_cache_add( $key, $value, $group, $expire );
+		}
+
+		return $values;
+	}
+endif;
+
+if ( ! function_exists( 'wp_cache_set_multiple' ) ) :
+	/**
+	 * Set multiple values to the cache in one call.
+	 *
+	 * Differs from wp_cache_add_multiple() in that it will always write data.
+	 *
+	 * Compat function to mimic wp_cache_set_multiple().
+	 *
+	 * @ignore
+	 * @since 6.0.0
+	 *
+	 * @see wp_cache_set_multiple()
+	 *
+	 * @param array  $data  Array of key and value to be set.
+	 * @param string $group Optional. Where the cache contents are grouped. Default empty.
+	 * @param int    $expire Optional. When to expire the cache contents, in seconds. Default 0 (no expiration).
+	 * @return array Array of return values.
+	 */
+	function wp_cache_set_multiple( array $data, $group = '', $expire = 0 ) {
+		$values = array();
+
+		foreach ( $data as $key => $value ) {
+			$values[ $key ] = wp_cache_set( $key, $value, $group, $expire );
+		}
+
+		return $values;
+	}
+endif;