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