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

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()
下一篇

发表评论

注册不是必须的

像素鱼丸
160 文章
2 评论
4 喜欢
最新文章

VooShop 商城主题

主题简介 Vooshop 是一个简单精美的 WordPress 主题,支持自适应、暗黑模式、多语言等功能,可以用于企业、团体、自由职业者或更广泛的主页。 Vooshop:回归 WooCommerce 的纯粹与极速 零冗余代码,零多余功能。一个完全依赖 WooCommerce 原生能力的轻量级主题。 Vooshop 不做 WooCommerce 做不到的事,我们只负责让它跑得更快。 市面上的主题总试 […]

XZhan 主题

主题简介 XZhan 主题(中文名称:小站主题)是一款 WordPress 企业主题,支持自适应、暗黑模式等功能,可快速构建高质量的企业网站。   主题特色 支持白天与暗黑模式 自适应设计,兼容多种主流浏览器 自定义主色调 LOGO扫光动画 自定义SMTP支持 内置SEO功能 文章支持点赞、分享和海报生成 丰富的小工具 侧边栏粘性滚动 简介的主题设置面板 主题设置可导入和备份 多级子菜单 […]

StarFish 配置框架

一个轻量级的 WordPress 选项框架插件,通过配置化的方式,快速为 WordPress 主题或插件生成后台设置页面。 ✨ 特性 🎯 配置驱动 UI:只需定义数组配置,自动生成完整的表单界面 📱 多页面架构:支持多个独立的设置页面 🎨 丰富的字段类型:包含 15+ 种常用字段类型 🔗 字段依赖系统:实现字段间的联动效果 ✅ 数据验证与清理:自动进行安全清理,防止 XSS 攻击 🚀 零依赖:使用 […]

什么是幽灵按钮

“幽灵按钮”(Ghost Button)是一种常见的网页与移动应用 UI 设计模式,指背景透明(或半透明)、仅通过边框(border)和文字(text)定义的按钮,视觉上“若隐若现”,仿佛“幽灵”一般——因此得名。 核心特征: 无填充色(transparent background) 背景完全透明(或与父容器同色),不遮挡背后内容。 清晰的边框(通常 1–2px 实线) 如 border: 2px […]
生成中...
扫描二维码
扫描二维码
确认购买

您确定要购买此资源吗?

微信扫码支付

请使用微信扫描二维码完成支付

订单号:

等待支付...