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

例子:

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',newexample_obj);//保存對象 (Object)

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

更新設置

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

參數:

$option

(字符串)(必須) 要更新的設置的鍵名。

默認值:None

$newvalue

(混合)(必須) 要更新的值,可以是任何數據類型,甚至是 Object.

默認值:None

例子:

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',newexample_obj2);//更新對象 (Object)

刪除設置

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

參數:

$option

(字符串)(必須) 要刪除的設置的鍵值。

默認值:None

例子:

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 語句。