云策 WordPress 开发者社区

函数文档

wp_cache_add_multiple()

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

概述

wp_cache_add_multiple() 函数用于一次性向缓存中添加多个键值对，提高缓存操作效率。它调用 WP_Object_Cache::add_multiple() 方法实现功能。

关键要点

  • 参数 $data 为必需数组，包含要设置的键值对。
  • 可选参数 $group 用于分组缓存内容，默认空字符串。
  • 可选参数 $expire 设置缓存过期时间（秒），默认 0 表示永不过期。
  • 返回值为布尔数组，按键分组，成功返回 true，若缓存键和组已存在则返回 false。
  • 该函数在 WordPress 6.0.0 版本中引入。

代码示例

function wp_cache_add_multiple( array $data, $group = '', $expire = 0 ) {
	global $wp_object_cache;

	return $wp_object_cache->add_multiple( $data, $group, (int) $expire );
}
📄 原文内容

Adds multiple values to the cache in one call.

Description

See also

Parameters

$dataarrayrequired
Array of keys and values to be set.
$groupstringoptional
Where the cache contents are grouped. Default empty.
$expireintoptional
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.

Source

function wp_cache_add_multiple( array $data, $group = '', $expire = 0 ) {
	global $wp_object_cache;

	return $wp_object_cache->add_multiple( $data, $group, (int) $expire );
}

View all references View on Trac View on GitHub

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

Adds multiple values to the cache in one call.
Used by Description
_prime_post_parent_id_caches()wp-includes/post.php

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

Updates the network cache of given networks.
update_site_cache()wp-includes/ms-site.php

Updates sites in cache.
WP_Query::get_posts()wp-includes/class-wp-query.php

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

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

Updates terms in cache.
update_post_cache()wp-includes/post.php

Updates posts in cache.
update_comment_cache()wp-includes/comment.php

Updates the comment cache of given comments.
update_meta_cache()wp-includes/meta.php

Updates the metadata cache for the specified objects.

Show 4 moreShow less

Changelog

Version Description
6.0.0 Introduced.