WordPress 数据库操作 WPDB 对象 $wpdb 用法

Question

WordPress 数据库操作 WPDB 对象 $wpdb 用法，开发 WordPress 主题的时候，难免会自定义查询语句，那么就需要用到 WordPress 中数据库操作对象 $wpdb，如果想直接使用 WP 里封装的数据库操作的类 wp-db.php，将 wp-load.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++;
 }

查询数据

$wpdb->query("DELETE FROM $wpdb->post WHERE post_id = ’13' “);

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

选出一个变量

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

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

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

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

选出一行

$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"

选出一列

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

一般选出

//$wpdb->get_results('query', output_type);
$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;
}

插入一行

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

更新

//$wpdb->update($table, $data, $where, $format = null, $where_format = null);
$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();