Options API(选项 API)于 WordPress 1.0 版本中引入,允许创建、读取、更新和删除 WordPress 选项。结合 Settings API(设置 API),它允许控制设置在设置页面中定义的选项。

选项存储在哪里?

选项存储在 {$wpdb->prefix}_options 表中。 $wpdb->prefix 由 wp-config.php 文件中设置的 $table_prefix 变量定义。

选项如何存储?

选项可以以两种方式存储在 WordPress 数据库中:作为单个值或作为值的数组。

单个值

当保存为单个值时,选项名称指代一个单一的值。

// add a new option
add_option('wporg_custom_option', 'hello world!');
// get an option
$option = get_option('wporg_custom_option');

值的数组

当保存为值的数组时,选项名称指代一个数组,该数组本身可能由键/值对组成。

// array of options
$data_r = array('title' => 'hello world!', 1, false );
// add a new option
add_option('wporg_custom_option', $data_r);
// get an option
$options_r = get_option('wporg_custom_option');
// output the title
echo esc_html($options_r['title']);

如果您正在处理大量相关的选项,将它们存储为数组可以对整体性能产生积极影响。


以单独的选项访问数据可能会导致许多单独的数据库事务,而通常来说,数据库事务是昂贵的操作(就时间和服务器资源而言)。当您存储或检索选项数组时,它在一个事务中发生,这是理想的。

函数参考

Add OptionGet OptionUpdate OptionDelete Option
add_option() get_option() update_option() delete_option()
add_site_option() get_site_option() update_site_option() delete_site_option()