WordPress Option API（數據庫儲存 API）

WordPress Option API 是提供給開發者的數據庫存儲機制，通過調用函數，可以快速、安全的把數據存儲到數據庫里（都在 wp_options 表）。

每個設置的模式是 key – value，利于擴展。Option API 不僅僅給主題和插件開發者用，連 WordPress 的很多設置都存儲在這里，比如網站名。

獲取設置

獲取設置是非常常用的操作，主要使用?get_option()?函數：

1	get_option( $option, $default );

參數：

$option

（字符串）（必須）要獲取的設置的鍵名。

默認值：None

$default

（混合）（可選）當數據庫中找不到指定的鍵值的時候，返回什么數據。

默認值：False

這個函數應該非常常見了，比如獲取博客的名字：

1	$blogname = get_option( 'name' );

添加設置

添加設置用?add_option()?函數，用法：

1	add_option( $option, $value, $deprecated, $autoload );

參數：

$option

（字符串）（必須）要添加的設置的鍵名，不能重復，設置已經存在則不會添加。

默認值：None

$value

（混合）（可選）要儲存的值，可以是任何數據類型，甚至是 Object.

默認值：空字符串

$deprecated

（字符串）（可選）歷史遺留變量，現在已經無用，不設置或者留空字符串即可。

默認值：空字符串

$autoload

（字符串）（可選）是否將該設置加入緩存，填寫 yes 或者 no.

默認值：yes

例子：

1 2 3 4 5 6

add_option( 'example_option', '保存一段話' );//保存字符串 add_option( 'example_option2', true );//保存布爾值 add_option( 'example_option3', array( 'a', 'b', 'c', 'd', 5, 6, true, false ) );//保存數組 add_option( 'example_option4', 12 );//保存整數 add_option( 'example_option5', 4.4123 );//保存浮點數 add_option( 'example_option6', new example_obj );//保存對象（Object）

注意，這個函數有一個重要的特性，就是如果指定鍵名的設置已經存在，就不會繼續添加。

更新設置

更新設置用?update_option()?函數，它不管設置是否存在，都會添加或者更新。

參數：

$option

（字符串）（必須）要更新的設置的鍵名。

默認值：None

$newvalue

（混合）（必須）要更新的值，可以是任何數據類型，甚至是 Object.

默認值：None

例子：

1 2 3 4 5 6

update_option( 'example_option', '更新一段話2' );//更新字符串 update_option( 'example_option2', false );//更新布爾值 update_option( 'example_option3', array( 'd', 'c', 'b', 'a' ) );//更新數組 update_option( 'example_option4', -11 );//更新整數 update_option( 'example_option5', 1.3123 );//更新浮點數 update_option( 'example_option6', new example_obj2 );//更新對象（Object）

刪除設置

刪除一個設置用?delete_option()?函數即可，直接指定鍵值就能刪除。

參數：

$option

（字符串）（必須）要刪除的設置的鍵值。

默認值：None

例子：

1 2 3 4 5 6

delete_option( 'example_option' ); delete_option( 'example_option2' ); delete_option( 'example_option3' ); delete_option( 'example_option4' ); delete_option( 'example_option5' ); delete_option( 'example_option6' );

小結

好好利用 Option API 可以輕松、安全的將數據保存到數據，省去麻煩的 Sql 語句。