WordPress 函数 add_option()、get_option() 和 update_option()
像素鱼丸
11-22
195
0

WordPress 有三个操作 wp_option 表的函数: add_option()、get_option() 和 update_option()

add_option() 函数

add_option() 是WordPress的一个核心函数,它用于在WordPress数据库中的wp_options表中安全地添加一个新的选项/值对。这个函数对于存储网站的自定义设置、插件配置或其他需要持久化的数据非常有用。

基本的函数签名如下:

add_option( string $option_name, mixed $option_value, string $deprecated = '', string $autoload = 'yes' )
  • $option_name:必需参数,是一个字符串,表示要添加的选项的名称。这个名称应当具有唯一性,并且不应与WordPress内部保留的选项名冲突。
  • $option_value:必需参数,是要保存的选项值,可以是任何PHP变量类型,包括字符串、数字、数组或对象。如果传递的是复杂类型,WordPress会在保存到数据库前自动对其进行序列化。
  • $deprecated:此参数在旧版本中曾用于提供选项的描述,现已被废弃,但仍保留以便向后兼容。通常在现代的WordPress开发中,我们可以忽略此参数。
  • $autoload:可选参数,决定选项是否应在WordPress启动时自动加载。接受 ‘yes’ 或 true 表示自动加载,这适用于那些经常需要访问的选项;而 ‘no’ 或 false 表示不自动加载,适合那些不常用的大容量数据,以优化数据库加载性能。

示例代码:

// 添加一个自定义选项,比如网站的主题颜色
$theme_color = 'blue';
add_option( 'my_theme_color', $theme_color );

// 添加一个自动加载的选项,例如API密钥
$api_key = 'your_api_key_here';
add_option( 'my_plugin_api_key', $api_key, '', 'yes' );

需要注意的是,如果要添加的选项已经存在于数据库中,add_option() 不会执行更新操作,而是保持原有选项不变。若要更新已存在的选项,请使用 update_option() 函数。

get_option() 函数

get_option() 是WordPress中的一个核心函数,用于从数据库中获取已保存的选项值。在WordPress中,许多设置和配置信息会被作为“选项”存储在数据库中,这些选项可以包含网站的基本配置、主题或插件的相关设置等。

该函数的基本使用格式如下:

get_option( $option_name, $default_value );
  • $option_name:必填参数,是你要获取的选项名称,通常是一个字符串。例如,如果你有一个名为“my_theme_color”的选项,那么你需要传入’ my_theme_color ‘作为这个参数。
  • $default_value:可选参数,如果提供的 $option_name 不存在或者其值为空时,get_option() 函数将返回此默认值。如果不指定,默认值为 false。

举例来说,如果你想获取站点标题(在WordPress中被作为 “blogname” 选项存储),你可以这样调用:

$site_title = get_option( 'blogname' );

通过 get_option() 函数,开发者能够方便地访问和管理存储在WordPress数据库中的全局配置信息,实现对网站个性化设定的读取和展示。

update_option() 函数

update_option() 是WordPress的一个核心函数,主要用于在WordPress数据库中更新或插入选项(options)。WordPress中的选项是一种持久化存储机制,常用来保存网站的各种配置信息、主题设置或插件设置等。

基本语法结构为:

update_option( $option_name, $new_value, $autoload );
  • $option_name:必需参数,是一个字符串,代表你想要更新或创建的选项名称。
  • $new_value:必需参数,是要存储的新值。它可以是任何类型的数据,如字符串、数字、数组或对象。如果传递的是非标量类型,WordPress会自动将其序列化后存储。
  • $autoload:可选参数,决定该选项是否应该在WordPress启动时自动加载。可能的值是 ‘yes’ 或 true(表示自动加载)、’no’ 或 false(表示不自动加载)。若省略此参数,则默认大多数情况下会根据之前该选项的设置来决定是否自动加载。

例如,要更改或新增一个名为 my_website_color 的选项,并将其值设为 ‘blue’:

update_option( 'my_website_color', 'blue' );

此函数首先检查 $option_name 是否已经存在于数据库中。如果存在,它会更新该选项的值;如果不存在,则会如同 add_option() 函数一样,创建一个新的选项并赋予给定的值。由于它的这种特性,在不知道选项是否存在的情况下,update_option() 常被用来确保数据库中始终存在某个选项及其最新的值。

收藏
打赏
WordPress 使用 shortcode() 增加编辑器功能
上一篇
WordPress 文章页作者信息 get_the_author() 和 get_the_author_meta()
下一篇

发表评论

注册不是必须的

像素鱼丸
148 文章
0 评论
4 喜欢
最新文章

如何使用 WordPress Setting API

使用 WordPress 的 Setting API 是在插件或主题中创建和管理设置页面的标准方式。它提供了一种结构化、安全的方式来保存和获取用户配置的选项。 ✅ 一、Setting API 简介 WordPress 的 Setting API 允许你: 创建设置页面(Settings Page) 注册设置字段(Settings Field) 验证和保存设置数据 使用表单提交来更新设置 ✅ 二、基 […]

详解 WordPress 的评论设置

好的,我们来详细梳理并总结 WordPress 中关于文章评论的两个核心控制层级:全局设置和单篇设置。理解这两者的关系(优先级)是管理网站评论的关键。 1. 全局设置 (Global Settings) —— 网站的“默认规则” 这是整个网站评论系统的总开关和默认行为准则。它决定了新发布的文章默认是什么样子的。 位置:WordPress 后台仪表盘 -> 设置 (Settings) -> […]

wp_handle_comment_submission 函数

wp_handle_comment_submission() 是 WordPress 中用于处理评论提交的核心函数之一。它通常在用户提交评论时被调用,负责验证和处理评论数据,并最终将评论插入到数据库中。 ✅ 函数作用 wp_handle_comment_submission() 的主要功能是: 验证用户提交的评论数据(如评论内容、用户名、邮箱等) 检查是否为垃圾评论(通过 Akismet 或其他过 […]

Mirage 主题 v2.89.0 发布

Mirage 主题 v2.89.0 发布 feat 懒加载图片增加灰色背景颜色 refactor 移除一些无用的js文件 fix 优化卡片列表样式 feat 如果设置里删除logo,就直接显示网站名称 fix 修复pc下拉菜单宽度的一个样式bug fix 修复未登录用户取消喜欢时产生的一个错误 fix 优化 wp_vt_star 表结构 下载地址:https://gitee.com/vthemec […]
生成中...
扫描二维码
扫描二维码
用户登录