WordPress Option API 是提供给开发者的数据库存储机制,通过调用函数,可以快速、安全的把数据存储到数据库里(都在 wp_options 表)。
每个设置的模式是 key – value,利于扩展。Option API 不仅仅给主题和插件开发者用,连 WordPress 的很多设置都存储在这里,比如网站名。
获取设置
获取设置是非常常用的操作,主要使用 get_option() 函数:
1 | |
参数:
$option
(字符串)(必须)要获取的设置的键名。
默认值:None
$default
(混合)(可选)当数据库中找不到指定的键值的时候,返回什么数据。
默认值:False
这个函数应该非常常见了,比如获取博客的名字:
1 | |
添加设置
添加设置用 add_option() 函数,用法:
1 | |
参数:
$option
(字符串)(必须)要添加的设置的键名,不能重复,设置已经存在则不会添加。
默认值:None
$value
(混合)(可选)要储存的值,可以是任何数据类型,甚至是 Object.
默认值:空字符串
$deprecated
(字符串)(可选)历史遗留变量,现在已经无用,不设置或者留空字符串即可。
默认值:空字符串
$autoload
(字符串)(可选)是否将该设置加入缓存,填写 yes 或者 no.
默认值:yes
例子:
1 2 3 4 5 6 | |
注意,这个函数有一个重要的特性,就是如果指定键名的设置已经存在,就不会继续添加。
更新设置
更新设置用 update_option() 函数,它不管设置是否存在,都会添加或者更新。
参数:
$option
(字符串)(必须)要更新的设置的键名。
默认值:None
$newvalue
(混合)(必须)要更新的值,可以是任何数据类型,甚至是 Object.
默认值:None
例子:
1 2 3 4 5 6 | |
删除设置
删除一个设置用 delete_option() 函数即可,直接指定键值就能删除。
参数:
$option
(字符串)(必须)要删除的设置的键值。
默认值:None
例子:
1 2 3 4 5 6 | |
小结
好好利用 Option API 可以轻松、安全的将数据保存到数据,省去麻烦的 Sql 语句。