函数文档

wp_clean_theme_json_cache()

💡 云策文档标注

概述

wp_clean_theme_json_cache() 函数用于清理 theme_json 组下的缓存数据,确保全局样式和设置能重新计算。它通过删除多个缓存键并调用 WP_Theme_JSON_Resolver::clean_cached_data() 来实现。

关键要点

  • 清理 theme_json 组下的缓存,包括全局样式表、SVG 过滤器、自定义设置、主题设置、自定义 CSS 和模板部件数据。
  • 调用 wp_cache_delete() 删除特定缓存键,并触发 WP_Theme_JSON_Resolver::clean_cached_data() 以清除缓存数据。
  • 此函数在 WordPress 6.2.0 版本中引入,用于优化主题 JSON 数据的缓存管理。

代码示例

function wp_clean_theme_json_cache() {
	wp_cache_delete( 'wp_get_global_stylesheet', 'theme_json' );
	wp_cache_delete( 'wp_get_global_styles_svg_filters', 'theme_json' );
	wp_cache_delete( 'wp_get_global_settings_custom', 'theme_json' );
	wp_cache_delete( 'wp_get_global_settings_theme', 'theme_json' );
	wp_cache_delete( 'wp_get_global_styles_custom_css', 'theme_json' );
	wp_cache_delete( 'wp_get_theme_data_template_parts', 'theme_json' );
	WP_Theme_JSON_Resolver::clean_cached_data();
}

📄 原文内容

Cleans the caches under the theme_json group.

Source

function wp_clean_theme_json_cache() {
	wp_cache_delete( 'wp_get_global_stylesheet', 'theme_json' );
	wp_cache_delete( 'wp_get_global_styles_svg_filters', 'theme_json' );
	wp_cache_delete( 'wp_get_global_settings_custom', 'theme_json' );
	wp_cache_delete( 'wp_get_global_settings_theme', 'theme_json' );
	wp_cache_delete( 'wp_get_global_styles_custom_css', 'theme_json' );
	wp_cache_delete( 'wp_get_theme_data_template_parts', 'theme_json' );
	WP_Theme_JSON_Resolver::clean_cached_data();
}

Changelog

Version Description
6.2.0 Introduced.