函数文档

wp_prime_option_caches_by_group()

💡 云策文档标注

概述

wp_prime_option_caches_by_group() 函数用于预加载特定选项组中所有已注册选项的缓存,以提高性能。

关键要点

  • 参数 $option_group 为字符串类型,必需,指定要加载选项的选项组。
  • 函数内部检查全局变量 $new_allowed_options 中是否存在指定选项组,若存在则调用 wp_prime_option_caches() 预加载缓存。
  • 此函数在 WordPress 6.4.0 版本中引入。

代码示例

function wp_prime_option_caches_by_group( $option_group ) {
    global $new_allowed_options;

    if ( isset( $new_allowed_options[ $option_group ] ) ) {
        wp_prime_option_caches( $new_allowed_options[ $option_group ] );
    }
}

注意事项

  • 确保 $option_group 参数正确对应已注册的选项组,否则函数可能不执行任何操作。
  • 相关函数 wp_prime_option_caches() 用于通过单次数据库查询预加载特定选项的缓存。

📄 原文内容

Primes the cache of all options registered with a specific option group.

Parameters

$option_groupstringrequired
The option group to load options for.

Source

function wp_prime_option_caches_by_group( $option_group ) {
	global $new_allowed_options;

	if ( isset( $new_allowed_options[ $option_group ] ) ) {
		wp_prime_option_caches( $new_allowed_options[ $option_group ] );
	}
}

Changelog

Version Description
6.4.0 Introduced.