WordPress 数据库操作WPDB对象($wpdb)用法详解

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

 

 

使用wordpress的时候，如果想直接使用WP里封装的数据库操作的类(wp-db.php),将wp-blog-header.php包含到代码中就可以使用了。

Php代码  

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

 

插入数据时，其中一种方法是使用wp-db类中的insert()函数。

Php代码  

1. $table = "test_table";  
2. $data_array = array(  
3. ‘column_1′ => ‘data1′,  
4. ‘column_2′ => ‘data2′  
5. );  
6. $wpdb->insert($table,$data_array);  

 

第一个参数是数据库表中的名字，第二个参数是要插入的数据，是一个数组。数组中的key的名字就是表中的列名。其实insert()函数还有第三个参数format，感兴趣的朋友可以在wp-db.php的方法定义里看看更新数据时，可以用update()函数，例如:

Php代码  

1. $table = "test_table";  
2. $data_array = array(  
3.  ‘column_1′ => ‘new_data1′  
4. );  
5. $where_clause = array(  
6. ‘column_2′ => ‘data2′  
7. );  
8. $wpdb->update($table,$data_array,$where_clause);  

 

要从数据库中取数据，也有很多种方法，其中一种如下：

Php代码  

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

 

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

 

 

查询

Php代码  

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

其中query的参数是任何mysql语句。返回值是有多少行被选出、影响。如果出错返回FALSE。

 

选出一个变量

Php代码  

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

其中query为要查询的mysql语句，如果为空的话，则表示从cache中选出。column_Offset和row_offet表示制定query返回值的第几列和第几行,缺省值为零。典型用法为：

Php代码  

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

这个sql只选出一个值，缺省的0行0列，即表示选出用户数目。目前还不清楚，这里为什么总是要加prepare在前面。

 

选出一行

Php代码  

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

query为要执行的mysql语句，output_type表示返回值是object，hash或者是数组；row_offset表示第几行。

 

缺省情况下output_type为object。

Php代码  

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

 
如果output_type=ARRAY_A,那么：

Php代码  

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

 
如果output_type=ARRAY_N,那么：

Php代码  

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

 

选出一列

Php代码  

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

一般选出

Java代码  

1. //$wpdb->get_results('query', output_type);  
2.   
3. <?php  
4. $fivesdrafts = $wpdb->get_results("SELECT ID, post_title FROM $wpdb->posts  
5. WHERE post_status = 'draft' AND post_author = 5");  
6.   
7. foreach ($fivesdrafts as $fivesdraft) {  
8. echo $fivesdraft->post_title;  
9. }  

 

插入一行

Java代码  

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

 
更新

Php代码  

1. //$wpdb->update( $table, $data, $where, $format = null, $where_format = null );  
2. <?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的语法是：

Php代码  

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

在query中可以包含%d,%S,%f，分别表示后面参数的类型是整数，字符和浮点，如果要显示%号，则用%%，语法和C语言里面的printf基本一样。

到这里基本上就讲完了。对一般数据库的处理应该都没有问题了。如果碰到问题可以在本文开始时提到的那篇文章中去查阅。

$wpdb是一个全局变量，包含多个关于数据库查询函数：

Php代码  

1. $wpdb -> get_results('query');  
2. $wpdb->query('query');  
3. $wpdb->get_var('query',column_offset,row_offset);  
4. $wpdb->get_row('query', output_type, row_offset);  
5. $wpdb->get_col('query',column_offset);  
6. $wpdb->get_results('query', output_type);  
7. $wpdb->insert( $table, $data, $format );  
8. $wpdb->update( $table, $data, $where, $format = null, $where_format = null );  
9. $wpdb->prepare( 'query' [, value_parameter, value_parameter ... ] );  
10. $wpdb->show_errors();  
11. $wpdb->hide_errors();  
12. $wpdb->print_error();  
13. $wpdb->get_col_info('type', offset);  
14. $wpdb->flush();   

 

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