说明

这是一种向选项数据库表中添加有名称的选项/值对的安全方法。如果所需选项已存在，add_option()不添加内容。选项被保存后，可通过get_option()来访问选项，通过update_option()来修改选项，还可以通过delete_option()删除该选项。

在INSERT语句前，add_option的值被$wpdb->escape 跳过。

WP 2.3系列版本或更高版本的用法

WP 2.3系列中，$description参数已经停用，wp_option表中也删除了该参数的值。用法相同，但不再使用第二个参数。

该函数在早期版本中的用法见下文

<?php add_option($name, $value = '', $deprecated = '', $autoload = 'yes'); ?>

WP 2.3系列版本或更高版本中该函数的示例

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

WP 2.3系列版本或更高版本中该函数的参数

$name

（字符串）（必需）需要添加的选项名称。用下划线隔开单词；不要使用大写字母——参数值会被存入数据库

默认值：None

$value

（字符串）（可选）当前选项名称的值。限制在2到32个字节内

默认值：Empty

$deprecated

（字符串）（可选）不再使用

默认值：Empty

$autoload

（字符串）（可选）当前选项是否需要被wp_load_alloptions函数自动加载（加载每个页面时将选项放在对象缓存中）？有效值：yes或no。

默认值：yes

$description停用前该函数的用法

In the last versions of wordpress (2.3.X) the parameter $description is deprecated and remove the values from the wp_options table.
The usage its the same but the seccond parameter its unused.
WP 2.3.X or newer 
<?php add_option($name, $value = '', $deprecated = '', $autoload = 'yes'); ?>


<?php add_option($name, $value = '', $description = '', $autoload = 'yes'); ?>

示例

<?php add_option("myhack_extraction_length", '255',   'Max length of extracted text in characters.', 'yes'); ?>  

$description停用前该函数的参数

$name

（字符串）（必需）需要添加的选项名称。用下划线隔开单词；不要使用大写字母——参数值会被存入数据库

默认值：None

$value

（字符串）（可选）当前选项名称的值。

默认值：Empty

$deprecated

（字符串）（可选）当前选项的描述性文字。描述可用在后台标签中。

默认值：Empty

$autoload

（字符串）（可选）当前选项是否需要被自动加载？有效值：yes或no。

默认值：yes

分类：中文手册