阐述 WordPress `wp_update_post_count_cache()` 函数的源码：如何高效地更新文章数量缓存。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

各位观众，晚上好！我是你们的老朋友，人称“代码界段子手”的程序员老王。今天咱们聊聊WordPress里一个看似不起眼，实则效率满满的小家伙：wp_update_post_count_cache()。

别看名字长，它干的活儿简单粗暴：更新文章数量缓存。但这缓存可不是闹着玩的，它直接关系到你博客首页、分类页面等地方文章数量的显示速度。如果每次都现查数据库，那你的网站就等着卡成PPT吧！

所以，这个函数，很重要！咱们今天就把它扒个精光，看看它到底是怎么做到高效更新的。

一、缓存是个好东西，但过期了就麻烦了！

在深入代码之前，咱们先聊聊缓存这玩意儿。

想象一下，你每天都要查字典。如果每次都从第一页翻到你要查的词，那得多累啊！聪明的做法是，把你经常查的词记在一个小本子上，下次直接查小本子，速度嗖嗖的。

缓存就是这个小本子。WordPress用缓存来存储一些经常需要用到的数据，比如文章数量、网站设置等等。这样，就不用每次都去数据库里捞，大大提高了网站的响应速度。

但是！缓存里的数据是有时效性的。如果你的文章数量更新了，缓存里的数据还是旧的，那就闹笑话了。所以，我们需要一种机制来更新缓存，保证数据的准确性。wp_update_post_count_cache() 就是干这个的。

二、源码剖析：wp_update_post_count_cache() 的真面目

废话不多说，直接上代码！为了方便理解，咱们把源码简化一下，保留核心逻辑。

function wp_update_post_count_cache( $posts, $single = false ) {
    global $wpdb;

    if ( ! $posts ) {
        return false;
    }

    $post_types = array();
    $term_ids = array();

    // 1. 遍历文章，提取文章类型和分类ID
    foreach ( (array) $posts as $post ) {
        if ( ! $post = get_post( $post ) ) {
            continue;
        }

        $post_type = get_post_type( $post );

        if ( ! in_array( $post_type, $post_types, true ) ) {
            $post_types[] = $post_type;
        }

        // 获取文章的所有分类ID
        $terms = get_the_terms( $post, 'category' ); // 可以根据实际分类法修改
        if ( $terms && ! is_wp_error( $terms ) ) {
            foreach ( $terms as $term ) {
                if ( ! in_array( $term->term_id, $term_ids, true ) ) {
                    $term_ids[] = $term->term_id;
                }
            }
        }
    }

    // 2. 更新文章类型的数量缓存
    foreach ( $post_types as $post_type ) {
        _update_post_type_count( $post_type );
    }

    // 3. 更新分类的数量缓存
    if ( ! empty( $term_ids ) ) {
        _update_term_post_counts( $term_ids, 'category', true ); // 可以根据实际分类法修改
    }

    return true;
}

// 更新单个文章类型的数量缓存 (内部函数)
function _update_post_type_count( $post_type ) {
    global $wpdb;

    $count = $wpdb->get_var( $wpdb->prepare(
        "SELECT COUNT(*) FROM $wpdb->posts WHERE post_type = %s AND post_status = 'publish'",
        $post_type
    ) );

    wp_cache_set( 'post_type_counts', array( $post_type => $count ), 'global' ); // 注意这里！
}

// 更新分类的数量缓存 (内部函数)
function _update_term_post_counts( $terms, $taxonomy = 'category', $do_deferred = true ) {
    global $wpdb;

    $terms = array_map( 'intval', (array) $terms );
    $term_list = implode( ',', $terms );

    $query = "SELECT term_taxonomy_id, count FROM {$wpdb->term_taxonomy} WHERE term_id IN ($term_list) AND taxonomy = %s";
    $query = $wpdb->prepare( $query, $taxonomy );
    $term_taxonomy_ids = $wpdb->get_results( $query, OBJECT_K );

    if ( empty( $term_taxonomy_ids ) ) {
        return;
    }

    $object_types = (array) apply_filters( 'term_counts_object_types', array( 'post' ), $taxonomy );

    $count_query = _get_term_post_counts_query( $terms, $taxonomy, $object_types ); // 核心查询构建函数

    $results = $wpdb->get_results( $count_query, OBJECT_K );

    if ( is_array( $results ) ) {
        foreach ( $results as $tt_id => $result ) {
            $term_taxonomy_ids[ $tt_id ]->count = absint( $result->num );
        }
    }

    foreach ( $term_taxonomy_ids as $tt_id => $tt ) {
        wp_cache_set( "term_taxonomy_id_$tt_id", $tt, 'terms' ); // 注意这里！
    }
}

// 构建分类文章数量查询 (内部函数)
function _get_term_post_counts_query( $terms, $taxonomy, $object_types ) {
    global $wpdb;

    $terms = array_map( 'intval', (array) $terms );
    $term_list = implode( ',', $terms );

    $object_types = array_map( array( $wpdb, 'escape' ), $object_types );
    $object_types = "'" . implode( "', '", $object_types ) . "'";

    $join  = "INNER JOIN {$wpdb->term_relationships} AS pl ON ( {$wpdb->posts}.ID = pl.object_id ) INNER JOIN {$wpdb->term_taxonomy} AS tt ON ( pl.term_taxonomy_id = tt.term_taxonomy_id )";
    $where = $wpdb->prepare( "WHERE tt.taxonomy = %s AND tt.term_id IN ($term_list) AND {$wpdb->posts}.post_type IN ($object_types) AND {$wpdb->posts}.post_status = 'publish'", $taxonomy );

    $count_query = "SELECT tt.term_taxonomy_id, COUNT(*) AS num FROM {$wpdb->posts} $join $where GROUP BY tt.term_taxonomy_id";

    return $count_query;
}

代码有点长，别怕，咱们一步一步来。

第一步：提取信息

函数一开始，先遍历传入的文章 $posts，提取两个关键信息：

文章类型 (post_type): 比如 post（文章）、page（页面）等等。
分类ID (term_id): 文章所属的分类的ID。

为什么要提取这些信息呢？因为我们要分别更新文章类型和分类的缓存。

第二步：更新文章类型缓存

对于每一种文章类型，都调用 _update_post_type_count() 函数来更新缓存。这个函数很简单，就是直接查询数据库，统计该类型下 publish 状态的文章数量，然后用 wp_cache_set() 函数把结果存到缓存里。

wp_cache_set( 'post_type_counts', array( $post_type => $count ), 'global' );

这里，'post_type_counts' 是缓存的键名，array( $post_type => $count ) 是要缓存的数据，'global' 表示这是一个全局缓存，所有页面都可以访问。

第三步：更新分类缓存

对于每一个分类ID，都调用 _update_term_post_counts() 函数来更新缓存。这个函数稍微复杂一点，它首先会构建一个SQL查询，统计该分类下 publish 状态的文章数量，然后用 wp_cache_set() 函数把结果存到缓存里。

wp_cache_set( "term_taxonomy_id_$tt_id", $tt, 'terms' );

这里，"term_taxonomy_id_$tt_id" 是缓存的键名，$tt 是要缓存的数据，'terms' 表示这是一个分类缓存。

三、效率优化：缓存的艺术

现在咱们来聊聊这个函数的高效之处。

批量更新

wp_update_post_count_cache() 接收一个文章数组 $posts 作为参数，这意味着它可以一次性更新多个文章的缓存。避免了对每个文章都单独查询数据库，大大减少了数据库的压力。

想象一下，你要给100个朋友发红包。你是选择一个一个发，还是把100个红包一起准备好，然后一次性发出去？当然是后者效率更高！
内部函数，分工明确

wp_update_post_count_cache() 把复杂的任务分解成几个小函数，每个函数只负责一部分工作。这样代码结构更清晰，也更容易维护。

_update_post_type_count() 负责更新文章类型的缓存。
_update_term_post_counts() 负责更新分类的缓存。
_get_term_post_counts_query() 负责构建分类文章数量的SQL查询。

就像一个工厂，有不同的部门负责不同的任务，最终组装成一个完整的产品。
SQL查询优化

_get_term_post_counts_query() 函数构建的SQL查询语句非常重要，它直接关系到查询的效率。这个函数使用了 JOIN 连接 wp_posts、wp_term_relationships 和 wp_term_taxonomy 三个表，并使用 WHERE 子句进行过滤，最终统计出每个分类下的文章数量。

这个SQL查询语句经过精心设计，尽量减少了不必要的数据读取，提高了查询速度。
*利用`wpcache`函数**

最核心的优化在于使用了 wp_cache_set() 和 wp_cache_get() 等函数来操作缓存。这些函数是WordPress提供的缓存API，它们可以根据配置选择不同的缓存后端，比如内存缓存（Memcached、Redis）或者数据库缓存。

使用内存缓存可以大大提高缓存的读写速度，因为内存的访问速度比硬盘快得多。

四、代码表格化：更清晰的理解

为了让大家更清晰地理解 wp_update_post_count_cache() 的工作流程，咱们用表格来总结一下：

步骤	函数	主要任务	优化手段
1	`wp_update_post_count_cache()`	接收文章数组，提取文章类型和分类ID	批量处理，减少数据库查询次数
2	`_update_post_type_count()`	更新文章类型的数量缓存	直接查询数据库，统计文章数量，使用 `wp_cache_set()` 存入缓存
3	`_update_term_post_counts()`	更新分类的数量缓存	构建SQL查询，统计分类下的文章数量，使用 `wp_cache_set()` 存入缓存
4	`_get_term_post_counts_query()`	构建分类文章数量的SQL查询	使用 `JOIN` 连接多个表，使用 `WHERE` 子句进行过滤，尽量减少不必要的数据读取，提高查询速度
5	`wp_cache_set()`, `wp_cache_get()`	操作缓存	使用WordPress提供的缓存API，可以根据配置选择不同的缓存后端，比如内存缓存（Memcached、Redis）或者数据库缓存

五、举个栗子：实际应用场景

咱们举个实际的例子，看看 wp_update_post_count_cache() 在哪里被用到。

假设你发布了一篇文章，这篇文章属于 "科技" 和 "互联网" 两个分类。当你点击 "发布" 按钮后，WordPress会自动调用 wp_update_post_count_cache() 函数，更新 "科技" 和 "互联网" 两个分类的文章数量缓存。

这样，当用户访问你的 "科技" 和 "互联网" 分类页面时，页面上显示的文章数量就是最新的，不会出现错误。

六、总结：小函数，大作用

wp_update_post_count_cache() 看起来只是一个小小的函数，但它在WordPress中扮演着非常重要的角色。它通过高效地更新文章数量缓存，保证了网站数据的准确性和响应速度。

咱们今天从源码剖析、效率优化、代码表格化和实际应用场景等方面，详细讲解了 wp_update_post_count_cache() 的工作原理。希望大家能够对这个函数有更深入的了解。

记住，代码的世界充满了各种各样的小函数，每个函数都有它独特的价值。掌握这些小函数，你就能构建出更强大、更高效的网站！

好了，今天的讲座就到这里。感谢大家的收听！下次再见！

发表回复 取消回复

发表回复取消回复