add_option 添加设置选项

文 / @WordPress主题

函数描述

add_option函数是一种将“选项/值”对添加到WordPress选项数据表中的安全方法。如果选项已存在,此函数将不会执行任何操作。选项添加后,可以通过get_option()函数获取选项值,update_opthion()函数更新值,delete_option()函数删除值。

我们不需要序列化选项值。如果选项值需要序列化,该函数在插入之前会自动序列化。我们可以先创建一个没有值的选项,然后再添加选项值。

在添加选项前,该函数会首先调用add_option检查该选项是否已经被添加。如果该选项已存在,函数将返回False,然后该函数将检查选项名称是否为被保护的名称,如果在alloptionsnotoptions中被保护,函数将停止执行并返回错误信息。如果选项名称在数据表中不存在,并且没有被保护,这个选项将被成功地添加到数据库中。

注意:add_option使用get_option确定选项名称是否已经存在。因为get_option默认返回False,如果在数据库中设置了一个选项的值为False(如:update_option($option_name,false)),然后调用add_option将改变这个值,因为对于add_option函数来说,这个选项看起来是不存在的。

使用方法

<?php add_option( $option, $value, $deprecated, $autoload ); ?>

参数

参数 数据类型 是否必需 描述 默认值
$option 字符串 需要获取的选项名称,下划线分隔,只能使用小写字母
$value 任意 如果没有从获取到值时,使用此参数作为默认值
$deprecated 字符串 在WordPress3.2中已弃用默认:空字符串
$autoload 字符串 是否可以被wp_load_alloptions()自动加载,(在每个页面加载时把所有选项放在一个对象缓存中) yes或no

返回值

布尔值,如果添加成功,返回True,添加失败返回False

使用示例

<?php add_option('myhack_extraction_length','255','','yes'); ?>

和update_option()比较

如果你想确认指定选项是否已经添加,可以使用update_option()。该函数将直接更新选项以判断期望的值是否存在,不会对选项名称进行检查。

注意:如果你使用update_option()添加选项,将不能指定autoload='no'。如果你需要指定autoload='no',而不能确定选项是否已存在,在调用add_option()之前,先调用delete_option()删除选项。

添加UTHEME为好友
扫码添加UTHEME微信为好友
· 分享WordPress相关技术文章,主题上新与优惠动态早知道。
· 微信端最大WordPress社群,限时免费入群。