Home » 开发 » wordpress函数add_option用法

wordpress函数add_option用法

add_option是一个安全的增加一对 选项名/值 到数据库的函数,如果数据库中已经存在,那么它不做任何动作。被保存后,就可以用get_option()获取它的值,用update_option()改变它的值,用delete_option()去删除.

你没有必要对值进行序列化。 如果它需要被序列化的话, 它会在添加到数据库之前就被序列化的。 你也可以先制作一些选项了之后再添加它们的值。

在添加add_option之前,你需要事先了解几个方面。 首先,检查这个选项是否已经存在了,并且,若这个选项重名了的话, 则返回false。 其次,检查确定这个选项的命名是否是该不受保护名称alloptions或notoptions中的一个, 覆盖受保护选项是否会出现错误信息等。 如果这个选项名称没有受保护,也没有存在的话,那么你就可以创这个选项了。

注解:add_option使用get_option来确定选项是否已经存在。 由于get_option的默认值是返回false, 若你在数据库中设置一个选项设置为false,例如,update_option($option_name, false), 则add_option的后续调用会更改值,因为它对于add_option来说该选项不存在。

Vs.update_option()
如果你想看一个给定选项是否已经存在,可以使用update_option()。 update_option() 可以绕开选项命名检查,直接更新所需的值,而不管值是否存在。

在4.2 (trac)之前的版本中,update_option不能指定autoload=’no’ 。 如果你需要指定autoload=’no’ , 并且确认选项是否存在的话,你要在调用add_option()之前调用delete_option()

用法:

参数
$option:(string)(必需)添加的选项名称。必须不能超过64字符,用下划线隔开单词,不能使用大写字母——这些将被存入数据库。

$value:(mixed) (可选) 选项名称的值。限制在2到32个字节内

$deprecated:(string)(可选)在WordPress 2.3版本中不再使用
默认为:Empty string

$autoload:(string)(可选)这个选项是否需要被wp_load_alloptions()函数自动加载(在每个页面加载上将选项放入对象缓存中)?有效值:yes或no。
默认为:yes

返回值:
如果选项没有被添加则为false,反之则为true

例子:

变更日记:
从1.0.0

源文件:
add_option()位于wp-includes/option.php.

资源:https://codex.wordpress.org/Function_Reference/add_option

雨田

一个喜欢折腾wordpress的爱好者,希望与大家一起探讨wp技术!