wordpress提供了一系列用于數(shù)據(jù)庫操作的函數(shù)類 $wpdb，此類是一個全局變量，每次使用時都需要先global $wpdb。
執(zhí)行數(shù)據(jù)庫查詢
你可以通過query函數(shù)在WordPress數(shù)據(jù)庫中執(zhí)行任何SQL查詢。不過我們推薦為SELECT查詢使用更為具體的函數(shù)。
query(‘query’); ?>
query
（字符串）你希望執(zhí)行的SQL語句。
函數(shù)返回一個與選定內(nèi)容的行數(shù)相應(yīng)的整數(shù)。如果發(fā)生MySQL錯誤，函數(shù)返回FALSE。（注意：0和FALSE都可能被返回，確保使用正確的比較運算符：equality == vs. identicality ===）。
注意：使用wpdb類中所有可執(zhí)行SQL查詢的函數(shù)時，都需要將所有輸入內(nèi)容/inputs進行字符轉(zhuǎn)義（如wpdb->escape($user_entered_data_string)）。見下文。
刪除ID為13的文章的“gargle”元關(guān)鍵字和值。
$wpdb->query(”DELETE FROM $wpdb->postmeta WHERE post_id = ’13’AND meta_key = ‘gargle’”);
由delete_post_meta執(zhí)行。
將頁面7設(shè)為頁面15的父級。
$wpdb->query(”UPDATE $wpdb->posts SET post_parent = 7WHERE ID = 15 AND post_status = ‘static’”);
選擇一個變量
get_var函數(shù)返回一個來自數(shù)據(jù)庫的變量。雖然只返回一個變量，但查詢結(jié)果會被整體緩存，供后期使用。如果沒有查詢結(jié)果，返回NULL。
get_var(‘query’,column_offset,row_offset); ?>
query
（字符串）你希望執(zhí)行的查詢。將該參數(shù)設(shè)為null會使函數(shù)返回上一個查詢緩存結(jié)果中的具體變量。
column_offset
（整數(shù)）預(yù)計的數(shù)據(jù)庫表的列數(shù)（0為表中第一列）。默認(rèn)值為0。
row_offset
（整數(shù)）預(yù)計的數(shù)據(jù)庫表的行數(shù)（0為表中第一行）。默認(rèn)值為0。
示例
檢索并返回用戶數(shù)量。
get_var($wpdb->prepare(“SELECT COUNT(*) FROM $wpdb->users;”));echo ‘
User count is ‘ . $user_count . ‘
’;?>
檢索并返回自定義字段值得總數(shù)。
get_var($wpdb->prepare(“SELECT sum(meta_value) FROM $wpdb->postmeta WHERE meta_key = %s”, $meta_key));echo ‘
Total miles is ‘.$allmiles . ‘
’;?>
選擇表行
從某個查詢中檢索一整行內(nèi)容，可使用get_row函數(shù)。該函數(shù)可將行作為對象、關(guān)聯(lián)數(shù)組或數(shù)值索引數(shù)組返回。如果查詢返回了多個行，函數(shù)只返回指定行，但所有返回的行都將被緩存以供日后使用。
get_row(‘query’, output_type, row_offset); ?>
query
（字符串）你希望執(zhí)行的查詢語句。
output_type
三個預(yù)定義的常量之一。默認(rèn)值為OBJECT。
OBJECT —— 返回的結(jié)果以對象形式輸出ARRAY_A ——返回的結(jié)果以關(guān)聯(lián)數(shù)組形式輸出ARRAY_N —— 返回的結(jié)果以數(shù)值索引數(shù)組形式輸出row_offset
（整數(shù)）預(yù)計的數(shù)據(jù)庫表的行數(shù)（0為表中第一行）。默認(rèn)值為0。
示例
獲取ID為10的鏈接的所有資料。
$mylink = $wpdb->get_row(“SELECT * FROM $wpdb->links WHERE link_id = 10”);$mylink對象的屬性即SQL查詢結(jié)果的行名稱（在該例中，即 $wpdb->links表中的所有行）。
echo $mylink->link_id; // prints “10”使用
$mylink = $wpdb->get_row(“SELECT * FROM $wpdb->links WHERE link_id = 10”, ARRAY_A);則會生成一個關(guān)聯(lián)數(shù)組：
echo $mylink[‘link_id’]; // prints “10”而
$mylink = $wpdb->get_row(“SELECT * FROM $wpdb->links WHERE link_id = 10”, ARRAY_N);則會生成一個數(shù)值索引數(shù)組：
echo $mylink[1]; // prints “10”
選擇表列
要選擇數(shù)據(jù)庫表中的一列內(nèi)容，可使用get_col函數(shù)。該函數(shù)輸出一個空間數(shù)組，如果查詢返回了多個列，函數(shù)只返回指定列，但所有返回的列都將被緩存以供日后使用。
get_col(‘query’,column_offset); ?>
query
（字符串）你希望執(zhí)行的查詢。將該參數(shù)設(shè)為null會使函數(shù)返回上一個查詢的緩存結(jié)果中的執(zhí)行表列。
column_offset
（整數(shù)）預(yù)計的數(shù)據(jù)庫表的列數(shù)（0為表中第一列）。默認(rèn)值為0。
示例
在這個例子中，我們假設(shè)有一個專注于發(fā)布汽車資訊的博客，博客中每篇文章都介紹了一輛特別的汽車（如1969 Ford Mustang）。此外我們將三個自定義字段——manufacture、model和year指定給各篇文章。這里我們的目的是顯示manufacturer（生產(chǎn)商）為Ford的所有文章的標(biāo)題，各個標(biāo)題按模型和年份排列。
可以利用wpdb類的get_col形式返回一個符合要求、以正確順序排列的文章ID數(shù)組。然后通過foreach構(gòu)造函數(shù)重復(fù)該文章ID數(shù)組，顯示每篇文章的標(biāo)題。本示例的SQL查詢由 Andomar編寫。
<?php$meta_key1 = ‘model’;$meta_key2 = ‘year’;$meta_key3 = ‘manufacturer’;$meta_key3_value = ‘Ford’;
$postids=$wpdb->get_col($wpdb->prepare(”SELECT key3.post_idFROM $wpdb->postmeta key3INNER JOIN $wpdb->postmeta key1on key1.post_id = key3.post_idand key1.meta_key = %sINNER JOIN $wpdb->postmeta key2on key2.post_id = key3.post_idand key2.meta_key = %sWHERE key3.meta_key = %sand key3.meta_value = %sORDER BY key1.meta_value, key2.meta_value”,$meta_key1, $meta_key2, $meta_key3, $meta_key3_value));
if ($postids) {echo ‘List of $meta_key3_value . ‘(s), sorted by ‘ . $meta_key1 . ‘, ‘ . $meta_key2;foreach ($postids as $id) {$post=get_post(intval($id));setup_postdata($post);?>
” rel=”bookmark” title=”Permanent Link to ”>
選擇生成的結(jié)果
get_results可以從數(shù)據(jù)庫中抽取函數(shù)生成的多行結(jié)果。Wpdb函數(shù)以數(shù)組形式返回整個查詢結(jié)果。數(shù)組中每個元素都對應(yīng)查詢結(jié)果中的一行，如get_row既可以是對象，也可以是關(guān)聯(lián)數(shù)組或數(shù)值型數(shù)組。
get_results(‘query’, output_type); ?>
query
（字符串）你希望執(zhí)行的查詢語句。將該參數(shù)設(shè)為null會使函數(shù)返回上一個查詢的緩存結(jié)果中的信息。
output_type
三個預(yù)定義的常量之一。默認(rèn)值為OBJECT。更多信息請見上文中的“選擇表行”。
OBJECT —— 以對象形式輸出返回的結(jié)果ARRAY_A ——以關(guān)聯(lián)數(shù)組形式輸出返回的結(jié)果ARRAY_N —— 以數(shù)值索引數(shù)組形式輸出返回的結(jié)果示例
獲取ID為5的用戶的所有文章草稿的ID和標(biāo)題并回應(yīng)標(biāo)題。
$fivesdrafts = $wpdb->get_results(“SELECT ID, post_title FROM $wpdb->postsWHERE post_status = ‘draft’ AND post_author = 5”);
foreach ($fivesdrafts as $fivesdraft) {echo $fivesdraft->post_title;}
獲取ID為5的用戶的所有文章草稿信息。
get_results(“SELECT * FROM $wpdb->postsWHERE post_status = ‘draft’ AND post_author = 5″);if ($fivesdrafts) :foreach ($fivesdrafts as $post) :setup_postdata($post);?>
” rel=”bookmark”title=”Permanent Link to ”>
Not Found
插入表行/列
在數(shù)據(jù)庫表中插入一行/列內(nèi)容。
示例
在一行中插入兩列內(nèi)容，第一個列的值為字符串，第二列的值為數(shù)字：
$wpdb->insert( ‘table’, array( ‘column1’ => ‘value1’, ‘column2’ => 123 ), array( ‘%s’, ‘%d’ ) )可能的值：- %s 為字符串，- %d 為十進制數(shù)字，- %f 為浮點。
更新表行/列
更新數(shù)據(jù)庫表中某行/列的內(nèi)容。
示例
要更新一個表行，其ID為1，該行第一列中的值是一個字符串，第二列中的值是一個數(shù)字：
$wpdb->update( ‘table’, array( ‘column1’ => ‘value1’, ‘column2’ => ‘value2’ ), array( ‘ID’ => 1 ), array( ‘%s’, ‘%d’ ), array( ‘%d’ ) )防止數(shù)據(jù)庫查詢遭到SQL注入式攻擊更多在WordPress中避免SQL攻擊的信息，請看數(shù)據(jù)驗證。這是WordPress代碼編寫者和插件開發(fā)者的必讀文章。
簡單地說，執(zhí)行SQL查詢以阻止SQL注入式攻擊前，SQL查詢中的所有數(shù)據(jù)都需要經(jīng)過SQL字符轉(zhuǎn)義?？梢酝ㄟ^prepare方法快速完成字符轉(zhuǎn)義，該方法使用 sprintf()-like語句。
prepare( ‘query'[, value_parameter, value_parameter … ] ); ?>
query
（字符串）你希望執(zhí)行的SQL查詢，以 %s 與%d作為占位符。
value_parameter
（字符串）提交到占位符中的值。該值此時必須沒有被SQL轉(zhuǎn)義。
示例
將Meta key => value pair “Harriet’s Adages” => “WordPress’ database interface is like Sunday Morning: Easy.”添加到ID為10的文章。
$metakey = “Harriet’s Adages”;$metavalue = “WordPress’ database interface is like Sunday Morning: Easy.”;
$wpdb->query( $wpdb->prepare( ”INSERT INTO $wpdb->postmeta( post_id, meta_key, meta_value )VALUES ( %d, %s, %s )”,10, $metakey, $metavalue ) );
由add_meta()執(zhí)行。
注意，這時你無須擔(dān)心引用字符串。不要直接將變量傳遞給SQL查詢，可將 %s作為字符串的占位符， %d作為整數(shù)的占位符。你可以傳遞任意個值，每一個都可以作為prepare()方法的新參數(shù)。
顯示/隱藏SQL錯誤
你可以用show_errors來顯示SQL錯誤，也可以用hide_errors隱藏SQL錯誤。
show_errors(); ?>hide_errors(); ?>
同樣也可以用print_error輸出近期的查詢所生成的錯誤。
print_error(); ?>
獲取數(shù)據(jù)庫表中某列信息利用get_col_info可以檢索到近期查詢的表列信息。當(dāng)你不了解某個函數(shù)返回的對象的屬性時，就可以通過get_col_info函數(shù)獲取信息。該函數(shù)從指定列中輸出所需信息，如果沒有指定某列，則函數(shù)輸出一個以查詢結(jié)果中所有列的信息為內(nèi)容的數(shù)組。
get_col_info(‘type’, offset); ?>
type
（字符串）你希望檢索的信息?？赡転橐韵氯魏沃抵唬ㄕ?ezSQL文檔）。默認(rèn)值為name。
name ——表列的名稱。默認(rèn)值table ——列所屬表格的表格名稱max_length —— 表列的最大長度not_null —— 若表列不為Null則值為1primary_key —— 若表列是一個主鍵，值為1unique_key —— 若表列是唯一鍵，值為1multiple_key —— 若表列是非唯一鍵，值為1numeric —— 若表列是數(shù)值型，值為1blob —— 若表列為BLOB，值為1type —— 表列的類型unsigned —— 若表列無符號，值為1zerofill —— 若表列為zero-filled，值為1offset
（整數(shù)）從某個檢索信息的表中指定表列（0為表中第一列）。默認(rèn)值為-1。
-1 —— 從所有表列中檢索信息。輸出一個數(shù)組。默認(rèn)值。非負(fù)整數(shù) —— 從指定的表列中檢索信息（0為表中第一列）。
清除緩存
用flush清除SQL結(jié)果緩存。
flush(); ?>
這會清除$wpdb->last_result、$wpdb->last_query以及$wpdb->col_info信息。
類變量$show_errors
是否顯示SQL錯誤信息。默認(rèn)為TRUE。
$num_queries
已經(jīng)被執(zhí)行的查詢次數(shù)
$last_query
最近一次已經(jīng)被執(zhí)行的查詢
$queries
將SAVEQUERIES常量設(shè)為TRUE（該常量默認(rèn)值為FALSE），可以保存所有數(shù)據(jù)庫查詢及其停止時間。如果SAVEQUERIES值為TRUE，你的查詢會被作為數(shù)組保存在$queries變量中。
$last_result
最近一次查詢結(jié)果。
$col_info
最近一次查詢結(jié)果的表列信息。參見獲取表列信息。
$insert_id
最近一次INSERT查詢?yōu)锳UTO_INCREMENT列生成的ID。
$num_rows
最近一次查詢返回的行數(shù)。
表在wpdb類中可以引用WordPress數(shù)據(jù)庫表。
$posts
關(guān)于文章的數(shù)據(jù)庫表
$users
關(guān)于用戶的數(shù)據(jù)庫表
$comments
評論表
$links
鏈接表
$options
選項表
$postmeta
元數(shù)據(jù)（自定義字段）表
$usermate
usermeta表中含有用戶的其它信息，如昵稱、個人說明與權(quán)限。
$terms
terms表中包括對分類目錄、鏈接分類、標(biāo)簽的“說明”（description）
$term_taxonomy
term_taxonomy表介紹了WordPress的不同分類（taxonomy）。分類目錄、鏈接分類、標(biāo)簽都是一種分類。
$term_relationships
term_relationships表中含有術(shù)語以及使用術(shù)語的對象之間的鏈接，即該表可以指向日志所屬的分類目錄。
