Ticket #20875: 20875.5.diff

src/wp-includes/cache-compat.php

@@ +1 @@
+<?php
+
+/**
+ *  Compatibility for cache drop-ins.
+ *
+ * @param $groups
+ * @since 5.0.0
+ * @return array
+ */
+function wp_cache_get_multiple( $groups ) {
+        $values = array();
+
+        foreach ( $groups as $group => $keys ) {
+                foreach ( $keys as $key ) {
+                        $values[ $group ][ $key ] = wp_cache_get( $key, $group );
+                }
+        }
+
+        return $values;
+}
+
+
+

src/wp-includes/cache.php

@@ -124 +124 @@
 }
 
 /**
+ * Gets multiple values from cache in one call.
+ *
+ * @since 5.0.0
+ * @uses $wp_object_cache Object Cache Class
+ *
+ * @param array $groups 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_multiple( $groups ) {
+        global $wp_object_cache;
+
+        return $wp_object_cache->get_multiple( $groups );
+}
+
+/**
  * Increment numeric cache item's value
  *
  * @since 3.3.0
@@ -557 +573 @@
         }
 
         /**
+         * Retrieves multiple values from the cache.
+         *
+         * @since 5.0.0
+         * @access public
+         *
+         * @param array $groups 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_multiple( $groups ) {
+                $values = array();
+
+                foreach ( $groups as $group => $keys ) {
+                        foreach ( $keys as $key ) {
+                                $values[ $group ][ $key ] = $this->get( $key, $group );
+                        }
+                }
+
+                return $values;
+        }
+
+        /**
          * Increments numeric cache item's value.
          *
          * @since 3.3.0

src/wp-includes/load.php

@@ -570 +570 @@
                 wp_cache_add_global_groups( array( 'users', 'userlogins', 'usermeta', 'user_meta', 'useremail', 'userslugs', 'site-transient', 'site-options', 'blog-lookup', 'blog-details', 'site-details', 'rss', 'global-posts', 'blog-id-cache', 'networks', 'sites' ) );
                 wp_cache_add_non_persistent_groups( array( 'counts', 'plugins' ) );
         }
+
+        if ( ! function_exists( 'wp_cache_get_multiple' ) ) {
+                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_get_multiple( 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 );
+        }
 }