为了便于访问数据库,WordPress提供了一个友好的数据库操作类:wpdb,该类定义在/wp-includes/wp-db.php文件中。wpdb类封装了所有的数据库操作函数,它是基于开源的数据库操作类ezSQL进行修改的,使其更适合于WordPress,也使其仅适用于mySQL数据库。同时,WordPress还提供了一个全局变量$wpdb,并将其实例化为wpdb类的对象。这样我们就可以直接使用$wpdb来调用所有的数据库操作函数。
通过这个$wpdb对象,我们可以对WordPress数据库进行任何操作,包括建表、查询、删除、更新等。要注意的是,如果要在自定义函数中使用$wpdb,必须先将其全局化(global $wpdb;)。
下面就详细介绍一下WordPress的数据库操作函数:
1、function query($query)
这个函数是最基本的数据库操作函数,$query为SQL语句,提交给数据库执行,结果分两种情况:
1). 如果是“insert|delete|update|replace”, 返回受影响行数,在“insert|replace”这种情况下,该函数会用$this->insert_id记录下新插入的ID。
2). 如果是“select”,该函数会用$this->last_result记录下查询到结果集,返回查询到的记录行数。
如果出错,则返回FALSE。
实例:
query( " UPDATE $wpdb->posts SET post_parent = 7 WHERE ID = 15 AND post_status = 'static' " ); ?>
2、function escape($data)
使用反斜线引用数据,也就是使用魔术引号。
实例:
escape($name); $email = $wpdb->escape($email); $wpdb->query("INSERT INTO myusers (id, name, email) VALUES (NULL, '$name', '$email')"); ?>
3、function insert($table, $data, $format = null)
这是插入记录函数,第一个参数是表的字段数组,第二个是数据数组,第三个用于规定$data中每个值的数据类型。插入数据返回1,否则为0。
实例:
insert( 'table', array( 'column1' => 'value1', 'column2' => 123 ), array( '%s', '%d' ) ); ?>
4、function update($table, $data, $where, $format = null, $where_format = null)
这是更新记录函数,第一个参数是表的字段数组,第二个是数据数组,第三个是条件数组,第四个和第五个分别用于规定$data和$where中每个值的数据类型。更新了为1,否则为0。
实例:
update( 'table', array( 'column1' => 'value1', // string 'column2' => 'value2' // integer (number) ), array( 'ID' => 1 ), array( '%s', // value1 '%d' // value2 ), array( '%d' ) ); ?>
5、function get_var($query = null, $x = 0, $y = 0)
这个函数只返回一个值,默认是第0行第0列。如果$query不为空,首先执行查询,如果$query为空的话,则表示从cache中选出;然后返回第X列第Y行的值。
实例:
get_var( $wpdb->prepare( "SELECT COUNT(*) FROM $wpdb->users;" ) ); echo "User count is {$user_count}
"; ?>
6、function get_row($query = null, $output = OBJECT, $y = 0)
返回一行,$output指定返回的类型,可以是ARRAY_A(关联数组)、ARRAY_N(数字数组)或者OBJECT(对象)。$y指定第几行。
实例:
默认情况下,$output的值为OBJECT,那么用法如下:
get_row("SELECT * FROM $wpdb->links WHERE link_id = 10"); echo $mylink->link_id; // prints "10" ?>
如果$output的值为ARRAY_A,那么用法如下:
get_row("SELECT * FROM $wpdb->links WHERE link_id = 10",ARRAY_A); echo $mylink['link_id']; // prints "10" ?>
如果$output的值为ARRAY_N,那么用法如下:
get_row("SELECT * FROM $wpdb->links WHERE link_id = 10",ARRAY_N); echo $mylink[1]; // prints "10" ?>
7、function get_col($query = null, $x = 0)
返回一列,$x指定第几列。
实例:
get_col("SELECT name, email FROM myusers", 0) foreach ( $names as $name ) { echo $name; } ?>
8、function get_results($query = null, $output = OBJECT)
返回查询的结果集,允许以ARRAY_A、ARRAY_N或者OBJECT三种方式返回。
实例:
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; } ?>
9、function get_col_info($info_type = 'name', $col_offset = -1)
返回字段信息。
实例:
get_col_info('name', 0); echo $col_name; ?>
10、function prepare($query = null)
这是一个可变参数函数,即函数的参数个数不确定。$query为SQL语句,其中可以包含像%s和%d这样的占位符,其它所有非占位符里面的%都要使用%%来代替。由于SQL语句中可能含有像单引号、双引号这样的特殊字符,如果不进行处理就直接提交给数据库,可能会导致错误或者出现安全问题。为此,我们可以通过prepare函数来对SQL语句进行预处理。其实该函数的用法非常简单,就跟C语言中的sprintf()和vsprintf()函数差不多。
用法:
prepare( 'query' [, value_parameter, value_parameter ...] ); ?>
实例:
query( $wpdb->prepare( " INSERT INTO $wpdb->postmeta ( post_id, meta_key, meta_value ) VALUES ( %d, %s, %s ) ", 10, $metakey, $metavalue ) ); ?>
当然,还有一些不常使用的函数,这里就不详细介绍了。另外还有两个常量:SAVEQUERIES和WP_DEBUG。设置SAVEQUERIES常量为TRUE,可以把在数据库里执行的所有查询及其停止时间保存到$this->queries这个数组中,以后调试的时候可以使用;而设置WP_DEBUG常量为TRUE,则可以输出错误。不过,这两个常量开关默认都没有打开,我们在测试的时候,可以在wp_config.php文件中将其开启。