mirror of
https://github.com/WordPress/WordPress.git
synced 2024-10-01 08:37:55 +02:00
a3f3c5c959
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. Built from https://develop.svn.wordpress.org/trunk@52700 git-svn-id: http://core.svn.wordpress.org/trunk@52289 1a063a9b-81f0-0310-95a4-ce76da25c4cd
121 lines
3.3 KiB
PHP
121 lines
3.3 KiB
PHP
<?php
|
|
/**
|
|
* Object Cache API functions missing from 3rd party object caches.
|
|
*
|
|
* @link https://codex.wordpress.org/Class_Reference/WP_Object_Cache
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Cache
|
|
*/
|
|
|
|
if ( ! function_exists( 'wp_cache_get_multiple' ) ) :
|
|
/**
|
|
* Retrieves multiple values from the cache in one call.
|
|
*
|
|
* Compat function to mimic wp_cache_get_multiple().
|
|
*
|
|
* @ignore
|
|
* @since 5.5.0
|
|
*
|
|
* @see wp_cache_get_multiple()
|
|
*
|
|
* @param array $keys Array of keys under which the cache contents are stored.
|
|
* @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 Array of values organized into groups.
|
|
*/
|
|
function wp_cache_get_multiple( $keys, $group = '', $force = false ) {
|
|
$values = array();
|
|
|
|
foreach ( $keys as $key ) {
|
|
$values[ $key ] = wp_cache_get( $key, $group, $force );
|
|
}
|
|
|
|
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;
|