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