Ticket #20875: 20875.10.diff

src/wp-includes/cache.php

@@ -127 +127 @@
 }
 
 /**
+ * Gets multiple values from cache in one call.
+ *
+ * @since 5.4.0
+ * @see WP_Object_Cache::get_multiple()
+ *
+ * @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_get_multiple( $keys, $group = '', $force = false ) {
+        global $wp_object_cache;
+
+        return $wp_object_cache->get_multiple( $keys, $group, $force );
+}
+
+/**
  * Increment numeric cache item's value
  *
  * @since 3.3.0

src/wp-includes/class-wp-object-cache.php

@@ -303 +303 @@
         }
 
         /**
+         * 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.
          *
          * @since 3.3.0

src/wp-includes/load.php

@@ -614 +614 @@
                 wp_redirect( $link );
                 die();
         }
+
+        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( 'foo1', 'foo2', 'foo3', ), 'group1' );
+
+                $expected = array(
+                        'foo1' => 'bar',
+                        'foo2' => 'bar',
+                        'foo3' => false,
+                );
+
+                $this->assertSame( $expected, $found );
+        }
 }

tests/phpunit/tests/pluggable.php

@@ -290 +290 @@
                                                 'force' => false,
                                                 'found' => null,
                                         ),
+                                        'wp_cache_get_multiple'              => array(
+                                                'keys',
+                                                'group' => '',
+                                                'force' => false,
+                                        ),
                                         'wp_cache_incr'                      => array(
                                                 'key',
                                                 'offset' => 1,