Ticket #20875: 20875.3.diff

src/wp-includes/cache.php

@@ -124 +124 @@
 }
 
 /**
+ * Gets multiple values from cache in one call.
+ *
+ * @since 4.6.0
+ * @uses $wp_object_cache Object Cache Class
+ * @see WP_Object_Cache::get_multi()
+ *
+ * @param array $keys Multidimensional array, where the array keys are cache group names,
+ *                    and the values are arrays of keys to be fetched from that group.
+ * @return array|bool Array of values organized into groups.
+ */
+function wp_cache_get_multi( $keys ) {
+        global $wp_object_cache;
+
+        return $wp_object_cache->get_multi( $keys );
+}
+
+/**
  * Increment numeric cache item's value
  *
  * @since 3.3.0
@@ -560 +577 @@
         }
 
         /**
+         * Retrieves multiple values from the cache.
+         *
+         * @since 4.6.0
+         * @access public
+         *
+         * @param array $keys Multidimensional array, where the array keys are cache group names,
+         *                    and the values are arrays of keys to be fetched from that group.
+         * @return array Array of values organized into groups.
+         */
+        public function get_multi( $keys ) {
+                $values = array();
+
+                foreach ( $keys as $group => $group_keys ) {
+                        foreach ( $group_keys as $group_key ) {
+                                $values[ $group ][ $group_key ] = $this->get( $group_key, $group );
+                        }
+                }
+
+                return $values;
+        }
+
+        /**
          * Increments numeric cache item's value.
          *
          * @since 3.3.0

tests/phpunit/tests/cache.php

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