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. |