钩子文档

expiration_of_transient_{$transient}

💡 云策文档标注

概述

此文档介绍 WordPress 中的 expiration_of_transient_{$transient} 过滤器钩子,用于在设置瞬态值之前过滤其过期时间。钩子名称的动态部分 $transient 对应瞬态名称。

关键要点

  • expiration_of_transient_{$transient} 是一个过滤器钩子,允许开发者在 set_transient() 函数设置瞬态值前修改过期时间。
  • 钩子参数包括 $expiration(过期时间,以秒为单位,0 表示永不过期)、$value(瞬态的新值)和 $transient(瞬态名称)。
  • 此钩子从 WordPress 4.4.0 版本引入,常用于自定义瞬态缓存策略。

📄 原文内容

Filters the expiration for a transient before its value is set.

Description

The dynamic portion of the hook name, $transient, refers to the transient name.

Parameters

$expirationint
Time until expiration in seconds. Use 0 for no expiration.
$valuemixed
New value of transient.
$transientstring
Transient name.

Source

$expiration = apply_filters( "expiration_of_transient_{$transient}", $expiration, $value, $transient );

Changelog

Version Description
4.4.0 Introduced.