wp-db.php,wordpress的數據庫操作類wp-db.php

WordPress為用戶提供了一系列用於數據庫操作的函數類——wpdb。Wpdb類建立在Justin Vincent編寫並維護的ezSQL類的基礎上。

一、使用須知

不可直接調用wpdb類中的方法,應使用全局變量,‘global $wpdb’。$wpdb是WordPress提供的一個全局變量,該全局變量是負責與WordPress數據庫交流的類的實例化。在使用$wpdb前,請記住全局化$wpdb,‘global $wpdb’。

可以用$wpdb對象從任何一個WordPress數據庫表(而非僅僅標准數據庫表)中讀取數據。例如,如果你需要從一個名為“mytable”的自定義表中選定一些信息,可以使用以下代碼:

$myrows = $wpdb->get_results( "SELECT id, name FROM mytable" );

$wpdb對象可以與任何數量的數據庫表交流,但這些數據庫表只能來自一個數據庫——WordPress數據庫。如果你要連接到其它數據庫(極少情況),那么你就需要用相應的連接細節信息從wpdb類中將你的對象實例化。如果需要設置多個數據庫,可以考慮使用 hyperdb。

二、執行數據庫查詢

你可以通過query函數在WordPress數據庫中執行任何SQL查詢。不過我們推薦為SELECT查詢使用更為具體的函數。

<?php  $wpdb->query('query'); ?>

參數:query,字符串:你希望執行的SQL語句。

函數返回一個與選定內容的行數相應的整數。如果發生MySQL錯誤,函數返回FALSE。注意:0和FALSE都可能被返回,確保使用正確的比較運算符:等於“==”,還是“ ===”。

注意:使用wpdb類中所有可執行SQL查詢的函數時,都需要將所有輸入內容/inputs進行字符轉義(如wpdb->escape($user_entered_data_string))。見下文。

示例

1.刪除ID為13並且meta_key 為“gargle”的值:

$wpdb->query("DELETE FROM $wpdb->postmeta WHERE post_id = '13' AND meta_key = 'gargle'");

也可由delete_post_meta函數執行,在./wp-admin/includes/post.php中。

2.ID為15的文章的父級設為7:

$wpdb->query("UPDATE $wpdb->posts SET post_parent = 7 WHERE ID = 15 AND post_status = 'static'");

三、選擇一個變量

get_var函數返回一個來自數據庫的變量。雖然只返回一個變量,但查詢結果會被整體緩存,供后期使用。如果沒有查詢結果,返回NULL。

<?php  $wpdb->get_var('query',column_offset,row_offset); ?>

參數:

(1)query:字符串,你希望執行的查詢。將該參數設為null會使函數返回上一個查詢緩存結果中的具體變量。

(2)column_offset:整數,預計的數據庫表的列數(0為表中第一列)。默認值為0。

(3)row_offset:整數,預計的數據庫表的行數(0為表中第一行)。默認值為0。

示例:

1. 檢索並返回用戶數量。

$user_count = $wpdb->get_var($wpdb->prepare("SELECT COUNT(*) FROM $wpdb->users;"));

echo '

User count is ' . $user_count . '

';

?>

2. 檢索並返回自定義字段值的總數。

$meta_key = ‘_edit_last’;

$allel=$wpdb->get_var($wpdb->prepare("SELECT sum(meta_value) FROM $wpdb->postmeta WHERE meta_key = %s", $meta_key));

echo '

Total_edit_lastis '.$allel. '

';

?>

注:$wpdb->prepare,Prepares a SQL query for safe execution.

四、選擇表行

從某個查詢中檢索一整行內容,可使用get_row函數。該函數可將行作為對象、關聯數組或數值索引數組返回。如果查詢返回了多個行,函數只返回指定行,但所有返回的行都將被緩存以供日后使用。

<?php  $wpdb->get_row('query', output_type, row_offset);  ?>

參數:

(1)query,字符串,你希望執行的查詢語句。

(2)output_type,預定義的常量,默認值為OBJECT

OBJECT —— 返回的結果以對象形式輸出

ARRAY_A ——返回的結果以關聯數組形式輸出

ARRAY_N —— 返回的結果以數值索引數組形式輸出

(3)row_offset,整數,預計的數據庫表的行數(0為表中第一行)。默認值為0。

示例:獲取ID為2的鏈接的所有資料:

$mylink = $wpdb->get_row("SELECT * FROM $wpdb->links WHERE link_id = 2");

$mylink對象的屬性即SQL查詢結果的行名稱(在該例中,即 $wpdb->links表中的所有行)。

echo $mylink->link_name; //輸出"WordPress China 博客  "

使用  $mylink = $wpdb->get_row("SELECT * FROM $wpdb->links WHERE link_id = 2", ARRAY_A);

則會生成一個關聯數組: echo $mylink['link_name'];     //輸出"WordPress China 博客  "

而     $mylink = $wpdb->get_row("SELECT * FROM $wpdb->links WHERE link_id = 2", ARRAY_N);

則會生成一個數值索引數組:echo $mylink[2];      //輸出"WordPress China 博客  "

五、選擇表列

要選擇數據庫表中的一列內容,可使用get_col函數。該函數輸出一個空間數組,如果查詢返回了多個列,函數只返回指定列,但所有返回的列都將被緩存以供日后使用。

<?php  $wpdb->get_col('query',column_offset); ?>

參數:

(1)query,字符串,你希望執行的查詢。將該參數設為null會使函數返回上一個查詢的緩存結果中的執行表列。

(2)column_offset,整數,預計的數據庫表的列數(0為表中第一列)。默認值為0。

六、選擇生成的結果

get_results可以從數據庫中抽取函數生成的多行結果。Wpdb函數以數組形式返回整個查詢結果。數組中每個元素都對應查詢結果中的一行,如get_row既可以是對象,也可以是關聯數組或數值型數組。

<?php  $wpdb->get_results('query', output_type); ?>

參數:

(1)query,字符串你希望執行的查詢語句。將該參數設為null會使函數返回上一個查詢的緩存結果中的信息。

(2)output_type,三個預定義的常量之一,默認值為OBJECT,

OBJECT —— 以對象形式輸出返回的結果

ARRAY_A ——以關聯數組形式輸出返回的結果

ARRAY_N —— 以數值索引數組形式輸出返回的結果

示例:獲取ID為5的用戶的所有文章的ID和標題,並打印出標題。

$fivesdrafts = $wpdb->get_results("SELECT ID, post_title FROM $wpdb->posts WHERE post_status = 'draft' AND post_author = 5");

foreach ($fivesdrafts as $fivesdraft) {

echo $fivesdraft->post_title;

}

七、插入表行/列

在數據庫表中插入一行/列內容, insert( $table, $data, $format = null ),如在一行中插入兩列內容,第一個列的值為字符串,第二列的值為數字:

$wpdb->insert( 'table', array( 'column1' => 'value1', 'column2' => 123 ), array( '%s', '%d' ) )

$format可能的值:- %s 為字符串,- %d 為十進制數字,- %f 為浮點。

示例:在usermeta表中,為id為1的用戶添加66666的QQ號信息

$wpdb->insert('wp_usermeta',array('user_id'=>1,'meta_key'=>'QQ','meta_value'=>'66666'));

八、更新表行/列

更新數據庫表中某行/列的內容,function update( $table, $data, $where, $format = null, $where_format = null ),如要更新一個表行,其ID為1,該行第一列中的值是一個字符串,第二列中的值是一個數字:

$wpdb->update( 'table', array( 'column1' => 'value1', 'column2' => 'value2' ), array( 'ID' => 1 ), array( '%s', '%d' ), array( '%d' ) )

示例:在usermeta表中,為id為1的用戶,更改QQ號信息為88888

$wpdb->update('wp_usermeta',array('meta_key'=>'QQ','meta_value'=>'88888'),array('umeta_id'=>17,'user_id'=>1));

九、防止數據庫查詢遭到SQL注入式攻擊

更多在WordPress中避免SQL攻擊的信息,請看數據驗證。這是WordPress代碼編寫者和插件開發者的必讀文章。

簡單地說,執行SQL查詢以阻止SQL注入式攻擊前,SQL查詢中的所有數據都需要經過SQL字符轉義。可以通過prepare方法快速完成字符轉義,該方法使用 sprintf()-like語句。

<?php  $sql = $wpdb->prepare( 'query'[, value_parameter, value_parameter ... ] ); ?>

參數:

(1)query,字符串,你希望執行的SQL查詢,以 %s 與%d作為占位符。

(2)value_parameter,字符串,提交到占位符中的值。該值此時必須沒有被SQL轉義。

示例

將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()執行,在./wp-admin/includes/post.php中。

注意,這時你無須擔心引用字符串。不要直接將變量傳遞給SQL查詢,可將 %s作為字符串的占位符, %d作為整數的占位符。你可以傳遞任意個值,每一個都可以作為prepare()方法的新參數。

十、顯示/隱藏SQL錯誤

你可以用show_errors來顯示SQL錯誤,也可以用hide_errors隱藏SQL錯誤。

<?php  $wpdb->show_errors(); ?>

<?php  $wpdb->hide_errors(); ?>

同樣也可以用print_error輸出近期的查詢所生成的錯誤。

<?php  $wpdb->print_error(); ?>

十一、獲取數據庫表中某列信息

利用get_col_info可以檢索到近期查詢的表列信息。當你不了解某個函數返回的對象的屬性時,就可以通過get_col_info函數獲取信息。該函數從指定列中輸出所需信息,如果沒有指定某列,則函數輸出一個以查詢結果中所有列的信息為內容的數組。

<?php  $wpdb->get_col_info('type', offset); ?>

參數:

(1)type,字符串,你希望檢索的信息。可能為以下任何值之一,默認值為name,

name ——表列的名稱。默認值

table ——列所屬表格的表格名稱

max_length —— 表列的最大長度

not_null —— 若表列不為Null則值為1

primary_key —— 若表列是一個主鍵,值為1

unique_key —— 若表列是唯一鍵,值為1

multiple_key —— 若表列是非唯一鍵,值為1

numeric —— 若表列是數值型,值為1

blob —— 若表列為BLOB,值為1

type —— 表列的類型

unsigned —— 若表列無符號,值為1

zerofill —— 若表列為zero-filled,值為1

(2)offset,整數,從某個檢索信息的表中指定表列(0為表中第一列),默認值為-1。

-1 —— 從所有表列中檢索信息。輸出一個數組。默認值。

非負整數 —— 從指定的表列中檢索信息(0為表中第一列)。

十二、清除緩存

用flush清除SQL結果緩存。

<?php  $wpdb->flush(); ?>

這會清除$wpdb->last_result、$wpdb->last_query以及$wpdb->col_info信息。

十三、類屬性

$show_errors:是否顯示SQL錯誤信息。默認為TRUE。

$num_queries:已經被執行的查詢次數

$last_query:最近一次已經被執行的查詢

$queries:將SAVEQUERIES常量設為TRUE(該常量默認值為FALSE),可以保存所有數據庫查詢及其停止時間。如果SAVEQUERIES值為TRUE,你的查詢會被作為數組保存在$queries變量中。

$last_result:最近一次查詢結果。

$col_info:最近一次查詢結果的表列信息。參見獲取表列信息。

$insert_id:最近一次INSERT查詢為AUTO_INCREMENT列生成的ID。

$num_rows:最近一次查詢返回的行數。

十四、數據表

在wpdb類中可以引用WordPress數據庫表,會顯示實際的表名,一般是加上前綴wp_

$posts :關於文章的數據庫表

$users:關於用戶的數據庫表

$comments:評論表

$links:鏈接表

$options:選項表

$postmeta:元數據(自定義字段)表

$usermate:usermeta表中含有用戶的其它信息,如昵稱、個人說明與權限。

$commentsmeta:評論表的元數據表

$terms:terms表中包括對分類目錄、鏈接分類、標簽的“說明”(description)

$term_taxonomy:term_taxonomy表介紹了WordPress的不同分類(taxonomy)。分類目錄、鏈接分類、標簽都是一種分類。

$term_relationships:term_relationships表中含有術語以及使用術語的對象之間的鏈接,即該表可以指向日志所屬的分類目錄。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值