钩子文档

pre_update_option

💡 云策文档标注

概述

pre_update_option 是一个 WordPress 过滤器钩子,用于在选项值可能被序列化和更新之前进行过滤。它允许开发者在选项保存到数据库前修改其值。

关键要点

  • pre_update_option 是一个过滤器钩子,在 update_option() 函数中调用,用于拦截和修改选项值。
  • 该钩子接受三个参数:$value(新的未序列化选项值)、$option(选项名称)和 $old_value(旧的选项值)。
  • 开发者可以使用此钩子来验证、清理或转换选项值,确保数据在保存前符合特定要求。
  • 此钩子自 WordPress 3.9.0 版本引入,是选项更新流程中的重要组成部分。

代码示例

$value = apply_filters( 'pre_update_option', $value, $option, $old_value );

📄 原文内容

Filters an option before its value is (maybe) serialized and updated.

Parameters

$valuemixed
The new, unserialized option value.
$optionstring
Name of the option.
$old_valuemixed
The old option value.

Source

$value = apply_filters( 'pre_update_option', $value, $option, $old_value );

Changelog

Version Description
3.9.0 Introduced.