Ticket #20875: 20875.7.diff

src/wp-includes/cache.php

@@ -123 +123 @@
         return $wp_object_cache->get( $key, $group, $force, $found );
 }
 
+/**
+ * Gets multiple values from cache in one call.
+ *
+ * @since 5.4.0
+ * @uses $wp_object_cache Object Cache Class
+ *
+ * @param array       $keys   array of keys to get from group.
+ * @param string      $group  Optional. Where the cache contents are grouped. Default empty.
+ * @param bool        $force  Optional. Whether to force an update of the local cache from the persistent
+ *                            cache. Default false.*
+ * @return array|bool Array of values.
+ */
+function wp_cache_multiple_get( $keys, $group = '', $force = false ) {
+        global $wp_object_cache;
+
+        return $wp_object_cache->get_multiple( $keys, $group, $force );
+}
+
 /**
  * Increment numeric cache item's value
  *
@@ -556 +574 @@
                 return false;
         }
 
+        /**
+         * Retrieves multiple values from the cache.
+         *
+         * @since  5.4.0
+         *
+         * @param array $keys        Array of keys to fetch.
+         * @param bool  $force       Optional. Unused. Whether to force a refetch rather than relying on the local
+         *                           cache. Default false.
+         *
+         * @return array Array of values organized into groups.
+         */
+        public function get_multiple( $keys, $group = 'default', $force = false ) {
+                $values = array();
+
+                foreach ( $keys as $key ) {
+                        $values[ $key ] = $this->get( $key, $group, $force );
+                }
+
+                return $values;
+        }
+
         /**
          * Increments numeric cache item's value.
          *

src/wp-includes/load.php

@@ -613 +613 @@
                 wp_redirect( $link );
                 die();
         }
+
+        if ( ! function_exists( 'wp_cache_multiple_get' ) ) {
+                require_once( ABSPATH . WPINC . '/cache-compat.php' );
+        }
 }
 
 /**

tests/phpunit/tests/cache.php

@@ -315 +315 @@
                 // Make sure $fake_key is not stored
                 $this->assertFalse( wp_cache_get( $fake_key ) );
         }
+
+        /**
+         * @ticket 20875
+         */
+        public function test_get_multiple() {
+                wp_cache_set( 'foo1', 'bar', 'group1' );
+                wp_cache_set( 'foo2', 'bar', 'group1' );
+                wp_cache_set( 'foo1', 'bar', 'group2' );
+
+                $found = wp_cache_multiple_get( array( 'foo1', 'foo2', 'foo3', ), 'group1' );
+
+                $expected = array(
+                        'foo1' => 'bar',
+                        'foo2' => 'bar',
+                        'foo3' => false,
+                );
+
+                $this->assertSame( $expected, $found );
+        }
 }