早上好，各位缓存爱好者！今天咱们来聊聊 WordPress 里那个神秘又好用的 get_transient() 函数，以及它背后的故事。准备好，我们要深入它的骨髓，看看它是如何处理过期缓存，又是怎样与 wp_options 表眉来眼去的。
第一幕：初识 Transient，缓存界的轻骑兵
get_transient()，顾名思义，就是获取一个“瞬态”数据。什么是瞬态？简单来说，就是那种你不想永久保存，但又不想每次都重新计算的数据。比如，你想缓存热门文章的列表，或者API请求的结果。这些数据过一段时间可能就失效了，没必要一直霸占着数据库。
Transient 就像一个快闪记忆，用完就扔（或者让它自己过期）。
第二幕：源码探秘，一层层揭开它的面纱
好，废话不多说，直接上源码！以下是 get_transient() 函数的简化版核心代码（基于 WordPress 6.4）：
function get_transient( string $transient ) {
/**
* Filters the value of an existing transient.
*
* The dynamic portion of the hook name, `$transient`, refers to the transient name.
*
* Passing a truthy value to the filter will effectively short-circuit retrieval,
* returning the passed value instead.
*
* @since 2.8.0
*
* @param mixed $value Value of transient. Might be false to indicate transient does not exist.
* @return mixed Value of transient.
*/
$pre = apply_filters( "pre_transient_{$transient}", false );
if ( false !== $pre ) {
return $pre;
}
$transient_option = '_transient_' . $transient;
$value = get_option( $transient_option );
if ( false === $value ) {
return false;
}
$expiration = get_option( '_transient_timeout_' . $transient );
if ( false !== $expiration && time() > $expiration ) {
delete_transient( $transient );
return false;
}
/**
* Filters the value of an existing transient.
*
* The dynamic portion of the hook name, `$transient`, refers to the transient name.
*
* @since 2.8.0
*
* @param mixed $value Value of transient.
* @return mixed Value of transient.
*/
return apply_filters( "transient_{$transient}", $value );
}别被代码吓到，咱们慢慢分析。
-
apply_filters( "pre_transient_{$transient}", false ): 这是一个前置过滤器。你可以通过这个过滤器来提前返回一个值，从而跳过后面的数据库查询。 就像一个VIP通道，如果你有特殊待遇，直接走这里，不用排队。 -
$transient_option = '_transient_' . $transient;: 这行代码很重要！它定义了存储 transient 值的 option 名称。比如，如果你的 transient 名称是my_awesome_data，那么实际存储在wp_options表中的 option 名称就是_transient_my_awesome_data。 -
$value = get_option( $transient_option );: 这里调用了get_option()函数，从wp_options表中获取 transient 的值。get_option()是 WordPress 核心函数，负责从wp_options表中读取数据。 -
$expiration = get_option( '_transient_timeout_' . $transient );: 同样重要！这行代码获取了 transient 的过期时间。注意，过期时间的 option 名称是_transient_timeout_my_awesome_data（假设 transient 名称是my_awesome_data）。 -
if ( false !== $expiration && time() > $expiration ) { ... }: 这是过期检查的核心逻辑。如果 transient 存在过期时间，并且当前时间已经超过了过期时间，那么就调用delete_transient()函数删除这个 transient，并返回false。 -
apply_filters( "transient_{$transient}", $value ): 这是一个后置过滤器。你可以通过这个过滤器来修改 transient 的值，然后再返回。
第三幕：wp_options 表的秘密，Transient 的藏身之处
wp_options 表是 WordPress 存储各种配置信息的地方。Transient 也存储在这里，但它们并不是以常规的方式存储的。
- Option Name: 以
_transient_开头，后面跟着 transient 的名称。例如：_transient_my_awesome_data - Option Value: transient 存储的值。可以是字符串、数组、对象等等。
- autoload:
no。Transient 不会被自动加载，只有当你调用get_transient()函数时才会加载。这可以减少数据库的负担。
同时，还有一个额外的 option 来存储过期时间：
- Option Name: 以
_transient_timeout_开头，后面跟着 transient 的名称。例如：_transient_timeout_my_awesome_data - Option Value: Unix 时间戳，表示过期时间。
- autoload:
no
我们可以用一个表格来总结一下：
| Option Name | Option Value | autoload | 说明 |
|---|---|---|---|
_transient_my_awesome_data |
存储的 transient 值 | no |
存储实际的缓存数据。可以是字符串、数组、对象等等。 |
_transient_timeout_my_awesome_data |
Unix 时间戳 | no |
存储 transient 的过期时间。当当前时间超过这个时间戳时，get_transient() 会返回 false，并自动删除这两个 option。 |
第四幕：过期处理，Transient 的生死轮回
过期处理是 get_transient() 函数的核心功能之一。让我们再次关注那段关键代码：
$expiration = get_option( '_transient_timeout_' . $transient );
if ( false !== $expiration && time() > $expiration ) {
delete_transient( $transient );
return false;
}这段代码做了两件事：
-
检查过期时间： 首先，它从
wp_options表中获取过期时间。如果不存在过期时间（false === $expiration），说明这个 transient 永不过期（当然，你可以手动删除它）。 -
过期删除： 如果存在过期时间，并且当前时间超过了过期时间 (
time() > $expiration)，那么就调用delete_transient()函数删除这个 transient。
delete_transient() 函数的源码如下：
function delete_transient( string $transient ): bool {
/**
* Fires immediately before a specific transient is deleted.
*
* The dynamic portion of the hook name, `$transient`, refers to the transient name.
*
* @since 2.8.0
*
* @param string $transient Transient name.
*/
do_action( "delete_transient_{$transient}" );
$option = '_transient_' . $transient;
$result = delete_option( $option );
if ( $result ) {
delete_option( '_transient_timeout_' . $transient );
/**
* Fires immediately after a specific transient is deleted.
*
* The dynamic portion of the hook name, `$transient`, refers to the transient name.
*
* @since 2.8.0
*
* @param string $transient Transient name.
*/
do_action( "deleted_transient_{$transient}" );
return true;
}
return false;
}delete_transient() 函数做了以下几件事：
do_action( "delete_transient_{$transient}" ): 删除 transient 之前的钩子。你可以通过这个钩子来执行一些清理工作。delete_option( $option ): 调用delete_option()函数删除 transient 的值。delete_option( '_transient_timeout_' . $transient ): 调用delete_option()函数删除 transient 的过期时间。do_action( "deleted_transient_{$transient}" ): 删除 transient 之后的钩子。
第五幕：使用示例，让 Transient 飞起来
说了这么多理论，不如来点实际的。下面是一些使用 get_transient() 的示例：
示例 1：缓存 API 请求结果
function get_api_data( string $api_url ) {
$transient_name = 'api_data_' . md5( $api_url );
$data = get_transient( $transient_name );
if ( false === $data ) {
// 没有缓存，发起 API 请求
$response = wp_remote_get( $api_url );
if ( is_wp_error( $response ) ) {
return false; // 处理错误
}
$body = wp_remote_retrieve_body( $response );
$data = json_decode( $body, true );
if ( ! is_array( $data ) ) {
return false; // 处理错误
}
// 缓存数据，有效期 1 小时
set_transient( $transient_name, $data, 1 * HOUR_IN_SECONDS );
}
return $data;
}在这个例子中，我们首先尝试从 transient 中获取 API 数据。如果 transient 不存在，我们就发起 API 请求，并将结果缓存起来，有效期为 1 小时。
示例 2：缓存复杂的数据库查询结果
function get_featured_posts() {
$transient_name = 'featured_posts';
$posts = get_transient( $transient_name );
if ( false === $posts ) {
// 没有缓存，执行数据库查询
$args = array(
'posts_per_page' => 5,
'category_name' => 'featured',
);
$posts = get_posts( $args );
// 缓存数据，有效期 30 分钟
set_transient( $transient_name, $posts, 30 * MINUTE_IN_SECONDS );
}
return $posts;
}在这个例子中，我们缓存了精选文章的列表。如果 transient 不存在，我们就执行数据库查询，并将结果缓存起来，有效期为 30 分钟。
第六幕：注意事项，让 Transient 安全起飞
在使用 get_transient() 函数时，需要注意以下几点：
- Transient 名称： transient 名称应该是唯一的，并且不要太长。最好使用有意义的名称，方便调试。
- 过期时间： 过期时间应该根据数据的变化频率来设置。如果数据变化频繁，过期时间应该短一些。如果数据变化不频繁，过期时间可以长一些。
- 数据类型： Transient 可以存储各种数据类型，包括字符串、数组、对象等等。但是，尽量避免存储大型对象，因为这会增加数据库的负担。
- 手动删除： 如果需要立即清除 transient，可以使用
delete_transient()函数。 - 不要滥用： Transient 是一种缓存机制，但并不是万能的。不要滥用 transient，否则可能会导致数据库膨胀。
第七幕：Transient 的替代方案，多一种选择多一份保障
虽然 get_transient() 很方便，但在某些情况下，它可能不是最佳选择。以下是一些替代方案：
- Object Cache： 如果你使用了 Redis 或 Memcached 等对象缓存，那么可以直接使用对象缓存 API 来存储数据。对象缓存的性能通常比
wp_options表更好。 - 自定义数据库表： 如果你需要存储大量数据，或者需要更复杂的查询，那么可以考虑创建自定义数据库表。
- 文件缓存： 可以将数据存储在文件中。文件缓存的优点是简单易用，缺点是性能可能不如对象缓存。
下面是一个表格，总结了各种缓存方案的优缺点：
| 缓存方案 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
get_transient() |
简单易用，无需额外配置。 | 性能可能不如对象缓存，数据存储在 wp_options 表中，可能会导致数据库膨胀。 |
适用于缓存少量数据，例如 API 请求结果、数据库查询结果等。 |
| Object Cache (Redis/Memcached) | 性能非常好，可以显著提高网站的响应速度。可以存储大量数据。 | 需要额外配置 Redis 或 Memcached，有一定的学习成本。 | 适用于缓存大量数据，例如整个页面、对象等等。 |
| 自定义数据库表 | 可以存储大量数据，可以执行更复杂的查询。 | 需要手动创建数据库表，有一定的开发成本。 | 适用于需要存储大量结构化数据，并且需要执行复杂查询的场景。 |
| 文件缓存 | 简单易用，无需额外配置。 | 性能可能不如对象缓存，需要处理文件读写操作。 | 适用于缓存静态资源，例如图片、CSS 文件、JavaScript 文件等等。 |
第八幕：总结，Transient 的一生
今天我们深入剖析了 WordPress 的 get_transient() 函数，了解了它的源码、过期处理机制以及与 wp_options 表的交互。希望通过今天的学习，你能更好地理解和使用 get_transient() 函数，为你的 WordPress 网站提速！
记住，Transient 就像一个短暂的火花，照亮你的网站，但最终会熄灭。掌握它的特性，才能让它发挥最大的作用。
下次再见！希望下次还能和大家一起探索 WordPress 更加有趣的角落。