Cache API: Make the placement of wp_cache_flush_group() more consistent.

Includes:
* Placing `WP_Object_Cache::flush_group()` next to `::flush()`.
* Placing `wp_cache_supports_group_flush()` next to `wp_cache_flush_group()`.
* Placing the `wp_cache_flush_group()` unit test next to the `::flush()` method test.
* Removing test name from assertion messages, as it is already mentioned directly above in case of failure.
* Adjusting function descriptions per the documentation standards.

Follow-up to [52706], [53763].

See #55647, #4476.

git-svn-id: https://develop.svn.wordpress.org/trunk@53767 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Sergey Biryukov
2022-07-23 14:56:51 +00:00
parent f0ddd2e2c2
commit c937a1a305
6 changed files with 76 additions and 76 deletions

View File

@@ -22,19 +22,6 @@ function wp_cache_init() {
$GLOBALS['wp_object_cache'] = new WP_Object_Cache();
}
/**
* Whether the object cache implementation supports flushing individual cache groups.
*
* @since 6.1.0
*
* @see WP_Object_Cache::flush_group()
*
* @return bool True if group flushing is supported, false otherwise.
*/
function wp_cache_supports_group_flush() {
return true;
}
/**
* Adds data to the cache, if the cache key doesn't already exist.
*
@@ -296,8 +283,9 @@ function wp_cache_flush_runtime() {
/**
* Removes all cache items in a group, if the object cache implementation supports it.
* Before calling this method, always check for group flushing support using the
* `wp_cache_supports_group_flush()` method.
*
* Before calling this function, always check for group flushing support using the
* `wp_cache_supports_group_flush()` function.
*
* @since 6.1.0
*
@@ -313,6 +301,19 @@ function wp_cache_flush_group( $group ) {
return $wp_object_cache->flush_group( $group );
}
/**
* Determines whether the object cache implementation supports flushing individual cache groups.
*
* @since 6.1.0
*
* @see WP_Object_Cache::flush_group()
*
* @return bool True if group flushing is supported, false otherwise.
*/
function wp_cache_supports_group_flush() {
return true;
}
/**
* Closes the cache.
*