clean_term_cache() - WordPress 函数参考中文文档

返回介绍

clean_term_cache()

发布于 2017-09-10 字数3777 浏览 928 评论 0

clean_term_cache( int|array $ids,  string $taxonomy = '',  bool $clean_taxonomy = true )

Will remove all of the term ids from the cache.


描述


参数

$ids

(int|array)
(Required)
Single or list of Term IDs.

$taxonomy

(string)
(Optional)
Can be empty and will assume tt_ids, else will use for context.

Default value: ”

$clean_taxonomy

(bool)
(Optional)
Whether to clean taxonomy wide caches (true), or just individual term object caches (false).

Default value: true


源代码

File: wp-includes/taxonomy.php

function clean_term_cache($ids, $taxonomy = '', $clean_taxonomy = true) {
	global $wpdb, $_wp_suspend_cache_invalidation;

	if ( ! empty( $_wp_suspend_cache_invalidation ) ) {
		return;
	}

	if ( !is_array($ids) )
		$ids = array($ids);

	$taxonomies = array();
	// If no taxonomy, assume tt_ids.
	if ( empty($taxonomy) ) {
		$tt_ids = array_map('intval', $ids);
		$tt_ids = implode(', ', $tt_ids);
		$terms = $wpdb->get_results("SELECT term_id, taxonomy FROM $wpdb->term_taxonomy WHERE term_taxonomy_id IN ($tt_ids)");
		$ids = array();
		foreach ( (array) $terms as $term ) {
			$taxonomies[] = $term->taxonomy;
			$ids[] = $term->term_id;
			wp_cache_delete( $term->term_id, 'terms' );
		}
		$taxonomies = array_unique($taxonomies);
	} else {
		$taxonomies = array($taxonomy);
		foreach ( $taxonomies as $taxonomy ) {
			foreach ( $ids as $id ) {
				wp_cache_delete( $id, 'terms' );
			}
		}
	}

	foreach ( $taxonomies as $taxonomy ) {
		if ( $clean_taxonomy ) {
			wp_cache_delete('all_ids', $taxonomy);
			wp_cache_delete('get', $taxonomy);
			delete_option("{$taxonomy}_children");
			// Regenerate {$taxonomy}_children
			_get_term_hierarchy($taxonomy);
		}

		/**
		 * Fires once after each taxonomy's term cache has been cleaned.
		 *
		 * @since 2.5.0
		 * @since 4.5.0 Added the `$clean_taxonomy` parameter.
		 *
		 * @param array  $ids            An array of term IDs.
		 * @param string $taxonomy       Taxonomy slug.
		 * @param bool   $clean_taxonomy Whether or not to clean taxonomy-wide caches
		 */
		do_action( 'clean_term_cache', $ids, $taxonomy, $clean_taxonomy );
	}

	wp_cache_set( 'last_changed', microtime(), 'terms' );
}

更新日志

Version 描述
2.3.0 Introduced.

相关函数

Uses

  • wp-includes/cache.php:
    wp_cache_delete()
  • wp-includes/cache.php:
    wp_cache_set()
  • wp-includes/taxonomy.php:
    clean_term_cache
  • wp-includes/plugin.php:
    do_action()
  • wp-includes/option.php:
    delete_option()
  • wp-includes/wp-db.php:
    wpdb::get_results()
  • Show 1 more use
    Hide more uses


Used By

  • wp-includes/category.php:
    clean_category_cache()
  • wp-includes/taxonomy.php:
    wp_update_term_count_now()
  • wp-includes/taxonomy.php:
    wp_update_term()
  • wp-includes/taxonomy.php:
    wp_insert_term()
  • wp-includes/taxonomy.php:
    wp_delete_term()
  • wp-includes/ms-functions.php:
    global_terms()
  • Show 1 more used by
    Hide more used by


User Contributed Notes

上一篇:clean_site_details_cache()

下一篇:clean_url()

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!