钩子文档

nonce_life

💡 云策文档标注

概述

本文档介绍 WordPress 中的 'nonce_life' 过滤器,用于自定义 nonce 的生命周期(以秒为单位)。默认值为 86,400 秒(一天),开发者可以通过此过滤器调整 nonce 的有效时间。

关键要点

  • 'nonce_life' 过滤器允许修改 nonce 的生命周期,参数包括 $lifespan(默认 86,400 秒)和 $action(非必需参数)。
  • 从 WordPress 6.1.0 版本开始,添加了 $action 参数,支持更精准的过滤器应用。
  • 相关函数 wp_nonce_tick() 用于生成 nonce 创建的时间相关变量。

代码示例

$nonce_life = apply_filters( 'nonce_life', DAY_IN_SECONDS, $action );

注意事项

  • 使用此过滤器时,需确保 $action 参数正确传递,以实现针对性的 nonce 生命周期调整。
  • 默认生命周期为一天,修改时应考虑安全性和用户体验的平衡。

📄 原文内容

Filters the lifespan of nonces in seconds.

Parameters

$lifespanint
Lifespan of nonces in seconds. Default 86,400 seconds, or one day.
$actionstring|int
The nonce action, or -1 if none was provided.

Source

$nonce_life = apply_filters( 'nonce_life', DAY_IN_SECONDS, $action );

Changelog

Version Description
6.1.0 Added $action argument to allow for more targeted filters.
2.5.0 Introduced.