云策 WordPress 开发者社区

函数文档

wp_cache_get_multiple()

查看官方原文 ↗
💡 云策文档标注

概述

wp_cache_get_multiple() 函数用于在一次调用中从缓存中检索多个值，提高效率。它调用 WP_Object_Cache::get_multiple() 方法实现功能。

关键要点

  • 参数：$keys（必需，数组类型，缓存键名数组）、$group（可选，字符串类型，缓存分组，默认为空）、$force（可选，布尔类型，是否强制从持久缓存更新本地缓存，默认为 false）。
  • 返回值：数组类型，按键名分组，每个值在成功时为缓存内容，失败时为 false。
  • 相关函数：与 WP_Object_Cache::get_multiple() 关联，并用于多个核心函数如 wp_prime_option_caches() 和 WP_Query::get_posts()。
  • 版本历史：自 WordPress 5.5.0 版本引入。

代码示例

function wp_cache_get_multiple( $keys, $group = '', $force = false ) {
    global $wp_object_cache;

    return $wp_object_cache->get_multiple( $keys, $group, $force );
}
📄 原文内容

Retrieves multiple values from the cache in one call.

Description

See also

Parameters

$keysarrayrequired
Array of keys under which the cache contents are stored.
$groupstringoptional
Where the cache contents are grouped. Default empty.
$forcebooloptional
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.

Source

function wp_cache_get_multiple( $keys, $group = '', $force = false ) {
	global $wp_object_cache;

	return $wp_object_cache->get_multiple( $keys, $group, $force );
}

View all references View on Trac View on GitHub

Uses Description
WP_Object_Cache::get_multiple()wp-includes/class-wp-object-cache.php

Retrieves multiple values from the cache in one call.
Used by Description
wp_cache_get_multiple_salted()wp-includes/cache-compat.php

Retrieves multiple items from the cache, only considering valid and unchanged items.
wp_prime_network_option_caches()wp-includes/option.php

Primes specific network options into the cache with a single database query.
wp_prime_option_caches()wp-includes/option.php

Primes specific options into the cache with a single database query.
_prime_post_parent_id_caches()wp-includes/post.php

Prime the cache containing the parent ID of various post objects.
wp_queue_posts_for_term_meta_lazyload()wp-includes/post.php

Queues posts for lazy-loading of term meta.
WP_Query::get_posts()wp-includes/class-wp-query.php

Retrieves an array of posts based on query variables.
_get_non_cached_ids()wp-includes/functions.php

Retrieves IDs that are not already present in the cache.
update_object_term_cache()wp-includes/taxonomy.php

Updates the cache for the given term object ID(s).
update_meta_cache()wp-includes/meta.php

Updates the metadata cache for the specified objects.

Show 4 moreShow less

Changelog

Version Description
5.5.0 Introduced.