wordpress 数据库操作WPDB对象($wpdb)用法

使用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++;
}

查询

<?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') ) ?>

更新

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的语法是:

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

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

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

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

 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();

get_row方法读取数据库中某一行的数据

从某个查询中检索一整行内容,可使用get_row函数。该函数可将行作为对象、关联数组或数值索引数组返回。如果查询返回了多个行,函数只返回指定行,但所有返回的行都将被缓存以供日后使用。

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

query:(字符串)你希望执行的查询语句。

output_type:三个预定义的常量之一。默认值为OBJECT。

  • OBJECT —— 返回的结果以对象形式输出
  • ARRAY_A ——返回的结果以关联数组形式输出
  • ARRAY_N —— 返回的结果以数值索引数组形式输出

row_offset:(整数)预计的数据库表的行数(0为表中第一行)。默认值为0。

示例

e.g.1?获取ID为10的链接的所有资料。

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

$mylink对象的属性即SQL查询结果的行名称(在该例中,即 $wpdb->links表中的所有行)。

echo $mylink->link_id; // prints "10"

使用

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

则会生成一个关联数组:

echo $mylink["link_id"]; // prints "10"

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

则会生成一个数值索引数组:

echo $mylink[1]; // prints "10"

e.g.2 获取ID为2所在行中,post_date的值

$gr = $wpdb->get_row("SELECT * FROM $wpdb->posts WHERE ID = 2");
echo $gr->post_date;

e.g.3 获取ID为2所在行所有资料

$gr = $wpdb->get_row("SELECT * FROM $wpdb->posts WHERE ID = 2");
foreach($gr as $a){
echo $a."||";
}

e.g.4 获取ID为2的用户昵称和注册时间

$user = $wpdb->get_row("SELECT user_nicename,user_registered FROM $wpdb->users WHERE ID=2");
echo "$user->user_nicename <br /> $user->user_registered";

get_col方法选择表中某一列的值

要选择数据库表中的一列内容,可使用get_col函数。该函数输出一个空间数组,如果查询返回了多个列,函数只返回指定列,但所有返回的列都将被缓存以供日后使用。

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

query:(字符串)你希望执行的查询。将该参数设为null会使函数返回上一个查询的缓存结果中的执行表列。

column_offset:(整数)预计的数据库表的列数(0为表中第一列)。默认值为0。

示例

e.g.1 获取所有用户的邮箱

$wp_user_email = $wpdb->get_col("SELECT DISTINCT user_email FROM $wpdb->users");
foreach($wp_user_email as $a){
echo $a."<br />";
}

get_var方法读取数据库中某个字段变量的值

get_var函数返回一个来自数据库的变量。虽然只返回一个变量,但查询结果会被整体缓存,供后期使用。如果没有查询结果,返回NULL。

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

query:(字符串)你希望执行的查询。将该参数设为null会使函数返回上一个查询缓存结果中的具体变量。

column_offset:(整数)预计的数据库表的列数(0为表中第一列)。默认值为0。

row_offset:(整数)预计的数据库表的行数(0为表中第一行)。默认值为0。

示例

1. 检索并返回用户数量。

<?php
$user_count = $wpdb->get_var($wpdb->prepare("SELECT COUNT(*) FROM $wpdb->users;"));
echo "<p>User count is " . $user_count . "</p>";
?>

$wpdb->prepare是为了保护查询SQL注入攻击,官方 wpdb页面中搜索“Protect Queries Against SQL Injection Attacks“

也有人解释是We’ll add the ‘prepare’ method to make sure we’re not dealing with an illegal operation or any illegal characters 大概的意思是”我们用添加prepare的方式来确定没有用一个非法操作或任何非法字符来进行处理“

2. 检索并返回自定义字段值的总数

<?php
$meta_key = "miles";//set this to appropriate custom field meta key
$allmiles=$wpdb->get_var($wpdb->prepare("SELECT sum(meta_value) FROM $wpdb->postmeta WHERE meta_key = %s", $meta_key));
echo "<p>Total miles is ".$allmiles . "</p>";
?>

未经允许不得转载:哈勃私语 » wordpress 数据库操作WPDB对象($wpdb)用法

本文共5550个字 创建时间:2017年12月9日15:14   

分享到:更多 ()