分析 WordPress `wp_get_object_terms()` 函数的源码：如何获取对象的分类术语，并支持缓存。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

咳咳，大家好！今天咱们来聊聊WordPress里的一个“老朋友”——wp_get_object_terms() 函数。这家伙虽然名字有点长，但用处可大了，它能帮你快速找到和某个“对象”（比如文章、页面、自定义文章类型）相关的分类术语。更厉害的是，它还懂得利用缓存来提升效率，避免每次都去数据库里翻箱倒柜。

咱们今天就来扒一扒它的源码，看看它到底是怎么工作的，顺便也学几招优化技巧。

一、啥是wp_get_object_terms()？简单说个事儿

想象一下，你写了一篇文章，给它贴了几个标签，比如“编程”、“WordPress”、“技巧”。 wp_get_object_terms() 的作用就是，给定这篇文章的ID，它能帮你把这些标签（也就是分类术语）找出来。

函数原型：

wp_get_object_terms( int|array $object_ids, string|array $taxonomies = 'post_tag', array $args = array() )

$object_ids: 要查询的对象 ID，可以是一个 ID，也可以是 ID 数组。
$taxonomies: 分类法的名称，比如 ‘category’（分类目录）、’post_tag’（标签）、’custom_taxonomy’（自定义分类法）。可以是一个字符串，也可以是字符串数组。默认是 ‘post_tag’。
$args: 一些额外的参数，可以用来控制返回结果，比如排序方式、数量限制等等。

返回值：

成功时，返回一个包含 WP_Term 对象的数组。如果没找到任何术语，返回一个空数组。如果出错，返回一个 WP_Error 对象。

二、源码解读：一步一步揭秘

咱们直接上代码，然后一句一句地分析：

function wp_get_object_terms( $object_ids, $taxonomies = 'post_tag', $args = array() ) {
    global $wpdb;

    $defaults = array( 'fields' => 'all', 'orderby' => 'name', 'order' => 'ASC', 'number' => '', 'offset' => '', 'search' => '', 'name__like' => '', 'slug' => array(), 'term_taxonomy_id' => array(), 'hierarchical' => true, 'child_of' => 0, 'get' => '', 'name' => '', 'pad_counts' => false, 'hide_empty' => false );

    $args = wp_parse_args( $args, $defaults );

    $object_ids = (array) $object_ids;

    $taxonomies = (array) $taxonomies;

    // 省略一些参数验证和兼容性处理的代码...

    $cache_key = 'get_object_terms:' . md5( serialize( compact( 'object_ids', 'taxonomies', 'args' ) ) );
    $cache = wp_cache_get( $cache_key, 'terms' );

    if ( false !== $cache ) {
        return apply_filters( 'wp_get_object_terms', $cache, $object_ids, $taxonomies, $args );
    }

    $terms = get_terms(
        array_merge(
            $args,
            array(
                'taxonomy' => $taxonomies,
                'object_ids' => $object_ids,
            )
        )
    );

    wp_cache_set( $cache_key, $terms, 'terms' );

    return apply_filters( 'wp_get_object_terms', $terms, $object_ids, $taxonomies, $args );
}

代码拆解：

参数处理：
- $defaults: 定义了一堆默认参数，比如排序方式、返回字段等等。
- wp_parse_args(): 把传入的 $args 和 $defaults 合并，确保所有参数都有值。这个函数非常实用，可以避免你手动判断参数是否存在。
- $object_ids = (array) $object_ids; 和 $taxonomies = (array) $taxonomies;: 把 $object_ids 和 $taxonomies 转换成数组，方便后续处理。即使你只传入一个 ID 或一个分类法名称，也会被转换成数组。
缓存机制：
- $cache_key = 'get_object_terms:' . md5( serialize( compact( 'object_ids', 'taxonomies', 'args' ) ) );: 生成一个缓存键。这个键包含了对象 ID、分类法名称和参数，只要这三者有任何变化，缓存键就会不同。 md5() 函数用于生成一个唯一的哈希值，serialize() 函数用于把数组转换成字符串。
- $cache = wp_cache_get( $cache_key, 'terms' );: 尝试从缓存中获取数据。 wp_cache_get() 函数会根据缓存键，从 WordPress 的对象缓存中查找数据。如果找到了，就直接返回缓存数据，避免了数据库查询。
- wp_cache_set( $cache_key, $terms, 'terms' );: 如果缓存中没有数据，就从数据库中查询，然后把结果保存到缓存中。 wp_cache_set() 函数会把数据保存到 WordPress 的对象缓存中，以便下次使用。
核心查询：
- $terms = get_terms(...): 这才是真正的数据库查询！它调用了 get_terms() 函数，把对象 ID 和分类法名称传进去，获取相关的分类术语。注意这里用了array_merge 把 $args 和包含 taxonomy和object_ids的数组合并。
- get_terms() 函数本身也支持缓存，所以这层调用实际上也受益于缓存机制。
过滤器：
- apply_filters( 'wp_get_object_terms', $terms, $object_ids, $taxonomies, $args );: 这是一个过滤器，允许你修改函数的结果。你可以在你的主题或插件中使用 add_filter() 函数，来修改 $terms 数组。这提供了极大的灵活性，可以满足各种定制需求。

流程图：

graph TD
    A[开始] --> B{检查缓存};
    B -- 缓存命中 --> C[返回缓存数据];
    B -- 缓存未命中 --> D[调用 get_terms() 查询数据库];
    D --> E[将结果保存到缓存];
    E --> F[应用过滤器];
    F --> G[返回结果];
    C --> F;
    G --> H[结束];

三、缓存原理：为啥要用缓存？

缓存的目的是减少数据库查询次数，提高网站的响应速度。 wp_get_object_terms() 函数利用 WordPress 的对象缓存来实现缓存。

WordPress 对象缓存：

WordPress 对象缓存是一个全局的、持久化的数据存储器。它可以把查询结果、配置信息等等数据保存在内存中，以便下次快速访问。 WordPress 默认使用内存缓存（如果服务器支持），也可以配置使用其他的缓存方案，比如 Memcached、Redis 等等。

缓存失效：

缓存不是永久有效的。当数据库中的数据发生变化时，缓存需要失效，以便下次查询时能获取最新的数据。 WordPress 会自动处理一些缓存失效的情况，比如当你更新文章、添加分类术语时，相关的缓存会自动失效。但是，在某些情况下，你可能需要手动清除缓存，比如当你修改了数据库中的数据，但 WordPress 没有自动检测到变化时。

四、优化技巧：让你的网站飞起来

正确使用缓存：
- 确保你的 WordPress 网站启用了对象缓存。可以使用插件，比如 WP Super Cache、W3 Total Cache 等等，来配置对象缓存。
- 避免频繁地清除缓存。只有在必要的时候才清除缓存。
- 监控缓存的命中率。如果缓存命中率很低，说明缓存没有起到应有的作用。可以尝试调整缓存的配置，或者优化你的代码，减少数据库查询次数。
减少数据库查询：
- 尽量使用 WordPress 提供的函数来获取数据，比如 wp_get_object_terms()、get_posts() 等等。这些函数都支持缓存，可以减少数据库查询次数。
- 避免在循环中进行数据库查询。如果需要在循环中获取数据，可以先把数据全部查询出来，然后保存在一个数组中，再在循环中使用数组中的数据。
- 使用 SQL 索引来加速查询。如果你的数据库表很大，可以为经常查询的字段添加索引。
合理使用参数：
- 尽量使用默认参数。如果默认参数能满足你的需求，就不要修改参数。修改参数可能会导致缓存失效，增加数据库查询次数。
- 只传递必要的参数。不要传递不必要的参数，这会增加缓存键的长度，降低缓存的命中率。
- 使用 number 参数来限制返回结果的数量。如果只需要获取一部分数据，可以使用 number 参数来限制返回结果的数量，避免获取过多的数据。
自定义缓存：
- 如果 WordPress 提供的缓存机制不能满足你的需求，可以自定义缓存。可以使用 WordPress 的 Transient API 来实现自定义缓存。
- 自定义缓存需要小心处理缓存失效的问题。确保在数据库中的数据发生变化时，缓存能及时失效。

五、案例分析：实战演练

假设我们有一个自定义文章类型 product，并且为它定义了一个自定义分类法 product_category。现在，我们要获取 ID 为 123 的 product 文章的所有 product_category 术语。

代码示例：

$product_id = 123;
$terms = wp_get_object_terms( $product_id, 'product_category' );

if ( ! is_wp_error( $terms ) ) {
    if ( ! empty( $terms ) ) {
        echo '<ul>';
        foreach ( $terms as $term ) {
            echo '<li><a href="' . esc_url( get_term_link( $term ) ) . '">' . esc_html( $term->name ) . '</a></li>';
        }
        echo '</ul>';
    } else {
        echo '<p>该产品没有分类。</p>';
    }
} else {
    echo '<p>获取分类失败。</p>';
    error_log( $terms->get_error_message() );
}

代码解释：

$product_id = 123;: 定义产品 ID。
$terms = wp_get_object_terms( $product_id, 'product_category' );: 调用 wp_get_object_terms() 函数，获取产品的所有分类术语。
if ( ! is_wp_error( $terms ) ): 检查返回值是否是 WP_Error 对象。如果是 WP_Error 对象，说明获取分类失败。
if ( ! empty( $terms ) ): 检查 $terms 数组是否为空。如果为空，说明产品没有分类。
foreach ( $terms as $term ): 循环遍历 $terms 数组，输出每个分类术语的链接。

六、总结：温故而知新

wp_get_object_terms() 函数是一个非常实用的函数，可以帮助你快速获取和某个对象相关的分类术语。它利用缓存来提高效率，避免频繁地查询数据库。通过理解它的源码和缓存原理，你可以更好地使用它，并对你的 WordPress 网站进行优化。

表格总结：

功能	描述
获取对象术语	根据对象 ID 和分类法名称，获取相关的分类术语。
支持缓存	利用 WordPress 对象缓存，减少数据库查询次数。
参数灵活	可以通过参数来控制返回结果，比如排序方式、数量限制等等。
可扩展	可以通过过滤器来修改函数的结果，满足各种定制需求。

好了，今天的分享就到这里。希望大家有所收获！记住，理解原理才能更好地应用，祝大家编程愉快！

发表回复 取消回复

发表回复取消回复