update_option()更新wp_option表中的选项/值对

目录

描述

译文

利用该函数在选项数据库表中更新一个有名称的选项/值对。在INSERT语句前,option_name的值被$wpdb->escape 跳过。

该函数可取代add_option,但不及add_option灵活。update_option会检查并判断选项是否已经存在。如果不存在,用add_option ('option_name', 'option_value')添加选项。除非用户需要指定add_option的选项参数,否则update_option()是一个可同时添加和更新选项的两用函数。

注意:wp_load_alloptions将要加载(或不加载)某个选项时,update_option()无法更新。在这种情况下,应在使用update_option()函数后使用delete_option。

原文

Use the function update_option() to update a named option/value pair to the options database table. The $option (option name) value is escaped with $wpdb->prepare before the INSERT statement but not the option value, this value should always be properly sanitized.

This function may be used in place of add_option, although it is not as flexible. update_option will check to see if the option already exists. If it does not, it will be added with add_option('option_name', 'option_value'). Unless you need to specify the optional arguments of add_option(), update_option() is a useful catch-all for both adding and updating options.

update_option() 描述

用法

<?php update_option$option$new_value$autoload ); ?>

update_option() 用法

参数

$option

(string) (必填) Name of the option to update. Must not exceed 64 characters. A list of valid default options to update can be found at the Option Reference.

默认值: None

$newvalue

(mixed) (必填) The NEW value for this option name. This value can be an integer, string, array, or object.

默认值: None

$autoload

(mixed) (可选) Whether to load the option when WordPress starts up. For existing options `$autoload` can only be updated using `update_option()` if `$value` is also changed. Accepts 'yes' or true to enable, 'no' or false to disable. For non-existent options, the default value is 'yes'.

默认值: null

update_option() 参数

历史

  • 4.2.0: $autoload parameter added
  • 添加于 版本: 1.0.0

update_option() 历史

源文件

update_option() 函数的代码位于 wp-includes/option.php.

update_option() 源文件

相关