first commit
This commit is contained in:
201
wp-includes/cache-compat.php
Normal file
201
wp-includes/cache-compat.php
Normal file
@ -0,0 +1,201 @@
|
||||
<?php
|
||||
/**
|
||||
* Object Cache API functions missing from 3rd party object caches.
|
||||
*
|
||||
* @link https://developer.wordpress.org/reference/classes/wp_object_cache/
|
||||
*
|
||||
* @package WordPress
|
||||
* @subpackage Cache
|
||||
*/
|
||||
|
||||
if ( ! function_exists( 'wp_cache_add_multiple' ) ) :
|
||||
/**
|
||||
* Adds multiple values to the cache in one call, if the cache keys don'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 keys and values 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 bool[] Array of return values, grouped by key. Each value is either
|
||||
* true on success, or false if cache key and group already exist.
|
||||
*/
|
||||
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' ) ) :
|
||||
/**
|
||||
* Sets 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 keys and values 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 bool[] Array of return values, grouped by key. Each value is either
|
||||
* true on success, or false on failure.
|
||||
*/
|
||||
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;
|
||||
|
||||
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 return values, grouped by key. Each value is either
|
||||
* the cache contents on success, or false on failure.
|
||||
*/
|
||||
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' ) ) :
|
||||
/**
|
||||
* Deletes 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 bool[] Array of return values, grouped by key. Each value is either
|
||||
* true on success, or false if the contents were not deleted.
|
||||
*/
|
||||
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_flush_runtime' ) ) :
|
||||
/**
|
||||
* Removes all cache items from the in-memory runtime cache.
|
||||
*
|
||||
* Compat function to mimic wp_cache_flush_runtime().
|
||||
*
|
||||
* @ignore
|
||||
* @since 6.0.0
|
||||
*
|
||||
* @see wp_cache_flush_runtime()
|
||||
*
|
||||
* @return bool True on success, false on failure.
|
||||
*/
|
||||
function wp_cache_flush_runtime() {
|
||||
if ( ! wp_cache_supports( 'flush_runtime' ) ) {
|
||||
_doing_it_wrong(
|
||||
__FUNCTION__,
|
||||
__( 'Your object cache implementation does not support flushing the in-memory runtime cache.' ),
|
||||
'6.1.0'
|
||||
);
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
return wp_cache_flush();
|
||||
}
|
||||
endif;
|
||||
|
||||
if ( ! function_exists( 'wp_cache_flush_group' ) ) :
|
||||
/**
|
||||
* Removes all cache items in a group, if the object cache implementation supports it.
|
||||
*
|
||||
* Before calling this function, always check for group flushing support using the
|
||||
* `wp_cache_supports( 'flush_group' )` function.
|
||||
*
|
||||
* @since 6.1.0
|
||||
*
|
||||
* @see WP_Object_Cache::flush_group()
|
||||
* @global WP_Object_Cache $wp_object_cache Object cache global instance.
|
||||
*
|
||||
* @param string $group Name of group to remove from cache.
|
||||
* @return bool True if group was flushed, false otherwise.
|
||||
*/
|
||||
function wp_cache_flush_group( $group ) {
|
||||
global $wp_object_cache;
|
||||
|
||||
if ( ! wp_cache_supports( 'flush_group' ) ) {
|
||||
_doing_it_wrong(
|
||||
__FUNCTION__,
|
||||
__( 'Your object cache implementation does not support flushing individual groups.' ),
|
||||
'6.1.0'
|
||||
);
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
return $wp_object_cache->flush_group( $group );
|
||||
}
|
||||
endif;
|
||||
|
||||
if ( ! function_exists( 'wp_cache_supports' ) ) :
|
||||
/**
|
||||
* Determines whether the object cache implementation supports a particular feature.
|
||||
*
|
||||
* @since 6.1.0
|
||||
*
|
||||
* @param string $feature Name of the feature to check for. Possible values include:
|
||||
* 'add_multiple', 'set_multiple', 'get_multiple', 'delete_multiple',
|
||||
* 'flush_runtime', 'flush_group'.
|
||||
* @return bool True if the feature is supported, false otherwise.
|
||||
*/
|
||||
function wp_cache_supports( $feature ) {
|
||||
return false;
|
||||
}
|
||||
endif;
|
Reference in New Issue
Block a user