在WordPress中,update_option()
和 get_option()
是两个非常常用的函数,用于保存和检索设置。以下是如何使用这两个函数的基本步骤:
1. 使用 update_option()
保存设置
update_option()
函数用于在WordPress数据库中更新一个选项的值。如果选项不存在,它将创建一个新的选项。
函数的基本语法如下:
bool update_option( string $option, mixed $value, string|bool $autoload = 'yes' )
$option
:选项名称(字符串),通常是独一无二的,用于引用特定的设置。$value
:要保存的值(混合类型),可以是字符串、数组、整数等。$autoload
:(可选)一个布尔值或字符串,表示这个选项是否在WordPress启动时自动加载。默认为 'yes'。
以下是一个示例,展示如何使用 update_option()
来保存一个名为 my_custom_setting
的设置:
// 设置一个名为 'my_custom_setting' 的选项,值为 'my_value'
update_option('my_custom_setting', 'my_value');
如果你要保存的是一个数组,可以这样做:
// 设置一个名为 'my_custom_settings' 的选项,值为一个数组
$settings_array = array(
'setting1' => 'value1',
'setting2' => 'value2',
// 更多设置...
);
update_option('my_custom_settings', $settings_array);
2. 使用 get_option()
检索设置
get_option()
函数用于从WordPress数据库中检索一个选项的值。
函数的基本语法如下:
mixed get_option( string $option, mixed $default = false )
$option
:要检索的选项名称(字符串)。$default
:(可选)如果选项不存在,返回的默认值(混合类型)。默认为false
。
以下是一个示例,展示如何使用 get_option()
来检索名为 my_custom_setting
的设置:
// 检索名为 'my_custom_setting' 的选项值
$my_value = get_option('my_custom_setting');
// 如果选项不存在,返回默认值 'default_value'
$my_value = get_option('my_custom_setting', 'default_value');
如果你之前保存的是一个数组,可以这样检索:
// 检索名为 'my_custom_settings' 的选项值
$settings_array = get_option('my_custom_settings');
注意事项
- 在使用这些函数时,确保你的代码在WordPress的
admin_init
或admin_menu
钩子中运行,或者是在相关的设置页面中。 - 选项名称应该具有唯一性,以避免与WordPress核心或其他插件/主题的选项冲突。
- 使用这些函数时,请确保遵循WordPress的数据验证和安全性最佳实践。