WordPress源码深度解析之：`WordPress`的`Transient`缓存：如何利用它进行跨请求的数据缓存。

各位观众老爷，晚上好！我是今天的主讲人，很高兴能和大家聊聊 WordPress 的 Transient 缓存。这玩意儿就像 WordPress 的“临时记忆”，能让你的网站跑得更快，更省资源。今天咱们就来扒一扒它的底裤，看看它到底是怎么工作的，以及怎么用它来让你的代码飞起来。

啥是 Transient？别跟我说“瞬态”！

Transient，如果你查字典，可能会看到“瞬态”这种高大上的词汇。但在 WordPress 的世界里，你可以把它理解成“临时存储的数据”。 简单来说，Transient 是一种用于存储临时数据的缓存机制。这些数据在一段时间后会自动过期失效。

想象一下，你写了个函数，这个函数每次都要从数据库里捞一堆数据，或者调用一个特别慢的 API。如果每次用户访问都重新执行这个函数，那你的服务器就得累死了。这时候，Transient 就能派上用场了。你可以把函数的结果存到 Transient 里，设置一个过期时间，比如 10 分钟。在这 10 分钟内，只要 Transient 里有数据，就直接从 Transient 里取，不用再去数据库或者 API 那里折腾了。

Transient 的好处：

• 加速网站: 避免重复计算和数据库查询，提高页面加载速度。
• 减轻服务器压力: 减少数据库和外部 API 的访问次数，降低服务器负载。
• 提高用户体验: 更快的页面加载速度意味着更好的用户体验。

Transient 的坏处：

• 数据不是永久的: Transient 数据会过期，如果过期时间设置不合理，可能会频繁地重新计算数据。
• 过度使用会占用资源: 如果存储了大量不需要的 Transient 数据，会占用数据库资源。
• 依赖 Object Cache: Transient 默认依赖 WordPress 的 Object Cache。如果 Object Cache 不可用（例如，没有配置 Redis 或 Memcached），Transient 会直接写入数据库，性能会受到影响。

Transient 的三板斧：set_transient(), get_transient(), delete_transient()

WordPress 提供了三个核心函数来操作 Transient：

1. set_transient( $transient, $value, $expiration ): 设置一个 Transient。

   • $transient: Transient 的名称（Key），必须是唯一的字符串。
   • $value: 要存储的数据（Value），可以是任何 PHP 数据类型，比如字符串、数组、对象等。
   • $expiration: 过期时间（Expiration），单位是秒。

2. get_transient( $transient ): 获取一个 Transient。

   • $transient: 要获取的 Transient 的名称。
   • 返回值：如果 Transient 存在且未过期，则返回存储的数据；如果 Transient 不存在或已过期，则返回 false。

3. delete_transient( $transient ): 删除一个 Transient。

   • $transient: 要删除的 Transient 的名称。
   • 返回值：true 表示删除成功，false 表示删除失败。

代码示例：用 Transient 缓存文章数量

假设你要在一个页面上显示文章的总数量，但是你不想每次都执行 wp_count_posts() 函数。你可以用 Transient 来缓存这个数量：

<?php

/**
 * 获取缓存的文章数量
 *
 * @return int 文章数量
 */
function get_cached_post_count() {
    $transient_name = 'my_post_count'; // Transient 的名称
    $post_count = get_transient( $transient_name ); // 尝试从 Transient 中获取数据

    if ( false === $post_count ) { // 如果 Transient 不存在或已过期
        $counts = wp_count_posts(); // 获取文章数量
        $post_count = $counts->publish; // 只获取已发布的文章数量

        set_transient( $transient_name, $post_count, 120 ); // 将文章数量存入 Transient，过期时间为 120 秒 (2 分钟)
    }

    return $post_count;
}

// 在页面上显示文章数量
echo '文章总数：' . get_cached_post_count();

?>

代码解析：

• get_cached_post_count() 函数首先尝试从 Transient 中获取文章数量，Transient 的名称是 my_post_count。
• 如果 get_transient() 函数返回 false，说明 Transient 不存在或者已经过期。
• 这时候，函数会调用 wp_count_posts() 获取文章数量，并将结果存入 Transient，过期时间设置为 120 秒。
• 最后，函数返回文章数量。

更高级的用法：结合 Object Cache

Transient 默认会使用 WordPress 的 Object Cache。Object Cache 可以将数据存储在内存中，这样可以更快地访问数据。如果你没有配置 Object Cache，Transient 会直接写入数据库，速度会慢很多。

你可以通过在 wp-config.php 文件中定义 WP_CACHE 常量来启用 Object Cache：

define( 'WP_CACHE', true ); // 启用 Object Cache

然后，你需要安装并配置一个 Object Cache 插件，比如 Redis Object Cache 或 Memcached Object Cache。

Transient 的清理：防止数据库膨胀

Transient 会存储在 wp_options 表中，如果 Transient 数据过多，可能会导致 wp_options 表变得非常大，影响数据库性能。

为了避免这种情况，你需要定期清理过期的 Transient 数据。WordPress 提供了一个内置的机制来自动清理过期的 Transient，但是这个机制可能不够及时。

你可以使用插件来更有效地清理过期的 Transient 数据，比如 Transient Cleaner。

Transient 的应用场景：

• 缓存复杂的查询结果: 缓存需要执行复杂查询才能得到的数据，比如自定义的统计数据。
• 缓存外部 API 的响应: 缓存外部 API 的响应数据，减少对外部 API 的访问次数。
• 缓存耗时的计算结果: 缓存需要进行大量计算才能得到的结果，比如复杂的数学公式计算。
• 缓存主题选项: 缓存主题选项，避免每次页面加载都从数据库中读取选项。
• 缓存插件设置: 缓存插件设置，避免每次页面加载都从数据库中读取设置。
• 缓存文章相关数据: 缓存文章的评论数量、浏览量等数据。
• 缓存用户相关数据: 缓存用户的头像、昵称等数据。

代码示例：缓存用户头像

<?php

/**
 * 获取缓存的用户头像
 *
 * @param int $user_id 用户 ID
 * @param int $size    头像大小
 *
 * @return string 用户头像 URL
 */
function get_cached_avatar_url( $user_id, $size = 96 ) {
    $transient_name = 'my_avatar_' . $user_id . '_' . $size; // Transient 的名称
    $avatar_url = get_transient( $transient_name ); // 尝试从 Transient 中获取数据

    if ( false === $avatar_url ) { // 如果 Transient 不存在或已过期
        $avatar_url = get_avatar_url( $user_id, array( 'size' => $size ) ); // 获取用户头像 URL

        set_transient( $transient_name, $avatar_url, 3600 ); // 将用户头像 URL 存入 Transient，过期时间为 3600 秒 (1 小时)
    }

    return $avatar_url;
}

// 在页面上显示用户头像
$user_id = get_current_user_id();
$avatar_url = get_cached_avatar_url( $user_id, 128 );
echo '<img src="' . esc_url( $avatar_url ) . '" alt="User Avatar">';

?>

表格：Transient 的总结

特性	描述
用途	缓存临时数据，提高网站性能。
核心函数	set_transient(), get_transient(), delete_transient()
存储位置	默认存储在 wp_options 表中，如果配置了 Object Cache，则存储在内存中。
过期时间	可以设置过期时间，单位是秒。
优点	提高网站速度，减轻服务器压力，提高用户体验。
缺点	数据不是永久的，过度使用会占用资源，依赖 Object Cache。
应用场景	缓存复杂的查询结果、外部 API 的响应、耗时的计算结果、主题选项、插件设置、文章相关数据、用户相关数据等。
注意事项	定期清理过期的 Transient 数据，避免 wp_options 表变得过大。

一些使用 Transient 的建议：

• 选择合适的过期时间: 根据数据的更新频率选择合适的过期时间。如果数据更新频繁，过期时间可以设置短一些；如果数据更新不频繁，过期时间可以设置长一些。
• 不要存储过大的数据: Transient 适合存储小到中等大小的数据。如果数据过大，可能会占用大量内存，影响性能。
• 使用唯一的 Transient 名称: Transient 名称必须是唯一的，否则可能会导致数据冲突。可以使用插件名称或函数名称作为 Transient 名称的前缀，以避免冲突。
• 注意数据类型: Transient 可以存储任何 PHP 数据类型，但是需要注意数据类型的一致性。如果存储的数据类型和获取的数据类型不一致，可能会导致错误。
• 测试 Transient 的效果: 在生产环境中使用 Transient 之前，最好先在测试环境中测试 Transient 的效果。可以使用 WordPress 的调试模式来查看 Transient 是否正常工作。
• 优雅降级: 如果 Object Cache 不可用，Transient 会直接写入数据库，性能会受到影响。因此，你需要考虑优雅降级方案。例如，你可以判断 Object Cache 是否可用，如果不可用，则禁用 Transient 或者使用其他缓存机制。

总结：

Transient 是 WordPress 中一个非常强大的缓存机制，可以有效地提高网站性能。但是，你需要合理地使用 Transient，避免过度使用或者使用不当。希望今天的讲解能帮助你更好地理解和使用 Transient。

今天的讲座就到这里，感谢各位的收看！希望大家以后能多用 Transient，让自己的 WordPress 网站跑得更快、更稳！如果大家有什么问题，欢迎随时提问。

（鞠躬下台）