WordPress Option API 是提供给开发者的数据库存储机制,通过调用函数,可以快速、安全的把数据存储到数据库的 wp_options 表里。

每个设置的模式是 「key–value」,利于扩展。 Option API 不仅仅给主题和插件开发者用,连 WordPress 的很多设置都存储在这里。

获取设置

获取设置是非常常用的操作,主要使用 get_option() 函数:

1

get_option($option,$default);

参数:

$option

(字符串)(必须) 要获取的设置的键名。

默认值:None

$default

(混合)(可选) 当数据库中找不到指定的键值的时候,返回什么数据。

默认值:False

这个函数应该非常常见了,比如获取博客的名字:

1

$blogname=get_option('name');

添加设置

添加设置用 add_option() 函数,用法:

1

add_option($option,$value,$deprecated,$autoload);

参数:

$option

(字符串)(必须) 要添加的设置的键名,不能重复,设置已经存在则不会添加。

默认值:None

$value

(混合)(可选) 要储存的值,可以是任何数据类型,甚至是 Object.

默认值:空字符串

$deprecated

(字符串)(可选) 历史遗留变量,现在已经无用,不设置或者留空字符串即可。

默认值:空字符串

$autoload

(字符串)(可选) 是否将该设置加入缓存,填写 yes 或者 no.

默认值:yes

例子:

add_option('example_option','保存一段话');//保存字符串

add_option('example_option2',true);//保存布尔值

add_option('example_option3',array('a','b','c','d',5,6,true,false));//保存数组

add_option('example_option4',12);//保存整数

add_option('example_option5',4.4123);//保存浮点数

add_option('example_option6',newexample_obj);//保存对象 (Object)

注意,这个函数有一个重要的特性,就是如果指定键名的设置已经存在,就不会继续添加。

更新设置

更新设置用 update_option() 函数,它不管设置是否存在,都会添加或者更新。

参数:

$option

(字符串)(必须) 要更新的设置的键名。

默认值:None

$newvalue

(混合)(必须) 要更新的值,可以是任何数据类型,甚至是 Object.

默认值:None

例子:

update_option('example_option','更新一段话 2');//更新字符串

update_option('example_option2',false);//更新布尔值

update_option('example_option3',array('d','c','b','a'));//更新数组

update_option('example_option4',-11);//更新整数

update_option('example_option5',1.3123);//更新浮点数

update_option('example_option6',newexample_obj2);//更新对象 (Object)

删除设置

删除一个设置用 delete_option() 函数即可,直接指定键值就能删除。

参数:

$option

(字符串)(必须) 要删除的设置的键值。

默认值:None

例子:

delete_option('example_option');

delete_option('example_option2');

delete_option('example_option3');

delete_option('example_option4');

delete_option('example_option5');

delete_option('example_option6');

小结

好好利用 Option API 可以轻松、安全的将数据保存到数据,省去麻烦的 Sql 语句。