WordPress 數據庫操作WPDB對象($wpdb)用法詳解

博客分類：  WP / Joomla! / Magento / Shopify / Drupal / Moodle / Zimbra

 

 

使用wordpress的時候，如果想直接使用WP裏封裝的數據庫操作的類(wp-db.php),將wp-blog-header.php包含到代碼中就可以使用了。

define(‘PATH’, dirname(dirname(__FILE__)).‘/’);
require_once(PATH . ‘../wp-blog-header.php’);
global $wpdb;

 

插入數據時，其中一種方法是使用wp-db類中的insert()函數。

$table = "test_table";
$data_array = array(
‘column_1′ => ‘data1′,
‘column_2′ => ‘data2′
);
$wpdb->insert($table,$data_array);

 

第一個參數是數據庫表中的名字，第二個參數是要插入的數據，是一個數組。數組中的key的名字就是表中的列名。其實insert()函數還有第三個參數format，感興趣的朋友可以在wp-db.php的方法定義裏看看更新數據時，可以用update()函數，例如:

$table = "test_table";
$data_array = array(
 ‘column_1′ => ‘new_data1′
);
$where_clause = array(
‘column_2′ => ‘data2′
);
$wpdb->update($table,$data_array,$where_clause);

 

要從數據庫中取數據，也有很多種方法，其中一種如下：

$querystr = "SELECT column_1 FROM test_table";
$results = $wpdb->get_results($querystr);
$i=0;
while ($i< count($results)){
echo $results[$i]->column_1."<br />";
$i++;
}

 

原文：http://kevin-wu.net/using-wpdb-object-in-wordpress/

 

 

查詢

<?php $wpdb->query("DELETE FROM $wpdb->post WHERE post_id = ’13′ “); ?>

其中query的參數是任何mysql語句。返回值是有多少行被選出、影響。如果出錯返回FALSE。

 

選出一個變量

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

其中query爲要查詢的mysql語句，如果爲空的話，則表示從cache中選出。column_Offset和row_offet表示制定query返回值的第幾列和第幾行,缺省值爲零。典型用法爲：

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

這個sql只選出一個值，缺省的0行0列，即表示選出用戶數目。目前還不清楚，這裏爲什麼總是要加prepare在前面。

 

選出一行

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

query爲要執行的mysql語句，output_type表示返回值是object，hash或者是數組；row_offset表示第幾行。

 

缺省情況下output_type爲object。

$mylink = $wpdb->get_row("SELECT * FROM $wpdb->links WHERE link_id = 10");
echo $mylink->link_id; // prints "10"

 
如果output_type=ARRAY_A,那麼：

$mylink = $wpdb->get_row("SELECT * FROM $wpdb->links WHERE link_id = 10", ARRAY_A);
echo $mylink['link_id']; // prints "10"

 
如果output_type=ARRAY_N,那麼：

$mylink = $wpdb->get_row("SELECT * FROM $wpdb->links WHERE link_id = 10", ARRAY_N);
echo $mylink[1]; // prints "10"

 

選出一列

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

一般選出

//$wpdb->get_results('query', output_type);

<?php
$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;
}

 

插入一行

//<?php $wpdb->insert( $table, $data, $format ); ?>
<?php $wpdb->insert('table', array('column1' => 'value1', 'column2' => 123 ), array('%s','%d') ) ?>

 
更新

//$wpdb->update( $table, $data, $where, $format = null, $where_format = null );
<?php $wpdb->update( 'table', array( 'column1' => 'value1', 'column2' => 'value2' ), array( 'ID' => 1 ), array( '%s', '%d' ), array( '%d' ) ) ?>

 
關於wpdb prepare
前面提到不清楚爲什麼每個mysql語句都會包在prepare中，這裏給出解釋：因爲mysql語句中可能含有單引號雙引號這樣的字符，如果不加 處理直接送給mysql，可能會導致錯誤。於是這裏通過一個prepare來對mysql語句進行預處理。prepare的語法是：

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

在query中可以包含%d,%S,%f，分別表示後面參數的類型是整數，字符和浮點，如果要顯示%號，則用%%，語法和C語言裏面的printf基本一樣。

到這裏基本上就講完了。對一般數據庫的處理應該都沒有問題了。如果碰到問題可以在本文開始時提到的那篇文章中去查閱。

$wpdb是一個全局變量，包含多個關於數據庫查詢函數：

$wpdb -> get_results('query');
$wpdb->query('query');
$wpdb->get_var('query',column_offset,row_offset);
$wpdb->get_row('query', output_type, row_offset);
$wpdb->get_col('query',column_offset);
$wpdb->get_results('query', output_type);
$wpdb->insert( $table, $data, $format );
$wpdb->update( $table, $data, $where, $format = null, $where_format = null );
$wpdb->prepare( 'query' [, value_parameter, value_parameter ... ] );
$wpdb->show_errors();
$wpdb->hide_errors();
$wpdb->print_error();
$wpdb->get_col_info('type', offset);
$wpdb->flush();

 

 更多：http://codex.wordpress.org/zh-cn:Class_Reference/wpdb