2003-05-28 04:41:04 -04:00
< ? php
2004-04-25 22:54:06 -04:00
// WordPress DB Class
// ORIGINAL CODE FROM:
// Justin Vincent (justin@visunet.ie)
// http://php.justinvincent.com
2004-04-25 22:28:06 -04:00
2004-04-25 22:54:06 -04:00
define ( 'EZSQL_VERSION' , 'WP1.25' );
define ( 'OBJECT' , 'OBJECT' , true );
define ( 'ARRAY_A' , 'ARRAY_A' , false );
define ( 'ARRAY_N' , 'ARRAY_N' , false );
2004-08-20 13:52:49 -04:00
2004-04-25 22:54:06 -04:00
if ( ! defined ( 'SAVEQUERIES' ))
define ( 'SAVEQUERIES' , false );
2004-04-25 22:28:06 -04:00
class wpdb {
var $show_errors = true ;
2006-02-12 02:53:23 -05:00
var $num_queries = 0 ;
2004-04-25 22:54:06 -04:00
var $last_query ;
var $col_info ;
2004-08-20 13:52:49 -04:00
var $queries ;
2003-05-28 04:41:04 -04:00
2004-05-24 04:22:18 -04:00
// Our tables
var $posts ;
var $users ;
var $categories ;
var $post2cat ;
var $comments ;
var $links ;
var $options ;
var $optiontypes ;
var $optionvalues ;
var $optiongroups ;
var $optiongroup_options ;
var $postmeta ;
2007-09-05 19:17:41 -04:00
var $usermeta ;
2007-05-22 01:12:38 -04:00
var $terms ;
var $term_taxonomy ;
var $term_relationships ;
2004-05-24 04:22:18 -04:00
2007-02-01 19:04:35 -05:00
var $charset ;
var $collate ;
2006-11-29 20:44:33 -05:00
/**
* Connects to the database server and selects a database
* @ param string $dbuser
* @ param string $dbpassword
* @ param string $dbname
* @ param string $dbhost
*/
2004-04-25 22:28:06 -04:00
function wpdb ( $dbuser , $dbpassword , $dbname , $dbhost ) {
2007-01-06 18:36:51 -05:00
return $this -> __construct ( $dbuser , $dbpassword , $dbname , $dbhost );
}
2007-02-27 10:24:54 -05:00
2007-01-06 18:36:51 -05:00
function __construct ( $dbuser , $dbpassword , $dbname , $dbhost ) {
register_shutdown_function ( array ( & $this , " __destruct " ));
2007-02-01 19:04:35 -05:00
if ( defined ( 'DB_CHARSET' ) )
$this -> charset = DB_CHARSET ;
if ( defined ( 'DB_COLLATE' ) )
$this -> collate = DB_COLLATE ;
2004-08-20 13:52:49 -04:00
$this -> dbh = @ mysql_connect ( $dbhost , $dbuser , $dbpassword );
2004-04-25 22:54:06 -04:00
if ( ! $this -> dbh ) {
2004-07-22 21:35:56 -04:00
$this -> bail ( "
< h1 > Error establishing a database connection </ h1 >
2005-04-18 23:25:14 -04:00
< p > This either means that the username and password information in your < code > wp - config . php </ code > file is incorrect or we can 't contact the database server at <code>$dbhost</code>. This could mean your host' s database server is down .</ p >
2004-07-22 21:35:56 -04:00
< ul >
< li > Are you sure you have the correct username and password ? </ li >
< li > Are you sure that you have typed the correct hostname ? </ li >
< li > Are you sure that the database server is running ? </ li >
</ ul >
< p > If you 're unsure what these terms mean you should probably contact your host. If you still need help you can always visit the <a href=' http :// wordpress . org / support / ' > WordPress Support Forums </ a >.</ p >
" );
2003-05-28 04:41:04 -04:00
}
2007-02-01 19:04:35 -05:00
if ( ! empty ( $this -> charset ) && version_compare ( mysql_get_server_info (), '4.1.0' , '>=' ) )
$this -> query ( " SET NAMES ' $this->charset ' " );
2004-04-25 22:28:06 -04:00
$this -> select ( $dbname );
}
2003-05-28 04:41:04 -04:00
2007-01-06 18:36:51 -05:00
function __destruct () {
2007-09-03 19:32:58 -04:00
return true ;
2007-01-06 18:36:51 -05:00
}
2006-11-29 20:44:33 -05:00
/**
* Selects a database using the current class ' s $this -> dbh
* @ param string $db name
*/
2004-04-25 22:28:06 -04:00
function select ( $db ) {
2004-08-20 13:52:49 -04:00
if ( !@ mysql_select_db ( $db , $this -> dbh )) {
2004-07-22 21:35:56 -04:00
$this -> bail ( "
< h1 > Can & #8217;t select database</h1>
< p > We were able to connect to the database server ( which means your username and password is okay ) but not able to select the < code > $db </ code > database .</ p >
< ul >
< li > Are you sure it exists ? </ li >
< li > On some systems the name of your database is prefixed with your username , so it would be like username_wordpress . Could that be the problem ? </ li >
</ ul >
2005-04-18 23:25:14 -04:00
< p > If you don 't know how to setup a database you should <strong>contact your host</strong>. If all else fails you may find help at the <a href=' http :// wordpress . org / support / ' > WordPress Support Forums </ a >.</ p > " );
2003-05-28 04:41:04 -04:00
}
2004-04-25 22:28:06 -04:00
}
2003-05-28 04:41:04 -04:00
2006-11-29 20:44:33 -05:00
/**
* Escapes content for insertion into the database , for security
*
* @ param string $string
* @ return string query safe string
*/
2005-07-04 02:27:04 -04:00
function escape ( $string ) {
2005-07-26 16:11:41 -04:00
return addslashes ( $string ); // Disable rest for now, causing problems
2005-07-02 19:31:43 -04:00
if ( ! $this -> dbh || version_compare ( phpversion (), '4.3.0' ) == '-1' )
return mysql_escape_string ( $string );
else
return mysql_real_escape_string ( $string , $this -> dbh );
2004-04-25 22:28:06 -04:00
}
2003-05-28 04:41:04 -04:00
2007-07-04 12:18:57 -04:00
/**
* Escapes content by reference for insertion into the database , for security
* @ param string $s
*/
function escape_by_ref ( & $s ) {
$s = $this -> escape ( $s );
}
/**
* Prepares a SQL query for safe use , using sprintf () syntax
*/
function prepare ( $args = NULL ) {
if ( NULL === $args )
return ;
$args = func_get_args ();
$query = array_shift ( $args );
2007-07-09 13:55:32 -04:00
$query = str_replace ( " '%s' " , '%s' , $query ); // in case someone mistakenly already singlequoted it
$query = str_replace ( '"%s"' , '%s' , $query ); // doublequote unquoting
2007-07-05 13:32:46 -04:00
$query = str_replace ( '%s' , " '%s' " , $query ); // quote the strings
2007-07-04 12:18:57 -04:00
array_walk ( $args , array ( & $this , 'escape_by_ref' ));
2007-07-05 13:32:46 -04:00
return @ vsprintf ( $query , $args );
2007-07-04 12:18:57 -04:00
}
2004-04-25 22:28:06 -04:00
// ==================================================================
// Print SQL/DB error.
2003-05-28 04:41:04 -04:00
2004-04-25 22:28:06 -04:00
function print_error ( $str = '' ) {
global $EZSQL_ERROR ;
2007-01-15 21:32:42 -05:00
if ( ! $str ) $str = mysql_error ( $this -> dbh );
2006-11-19 02:56:05 -05:00
$EZSQL_ERROR [] =
2004-04-25 22:54:06 -04:00
array ( 'query' => $this -> last_query , 'error_str' => $str );
2004-04-25 22:28:06 -04:00
2006-07-28 21:45:17 -04:00
$str = htmlspecialchars ( $str , ENT_QUOTES );
$query = htmlspecialchars ( $this -> last_query , ENT_QUOTES );
2004-04-25 22:28:06 -04:00
// Is error output turned on or not..
if ( $this -> show_errors ) {
// If there is an error then take note of it
print " <div id='error'>
2004-11-18 21:18:23 -05:00
< p class = 'wpdberror' >< strong > WordPress database error :</ strong > [ $str ] < br />
2006-07-28 18:58:38 -04:00
< code > $query </ code ></ p >
2004-04-25 22:28:06 -04:00
</ div > " ;
} else {
2006-02-12 02:53:23 -05:00
return false ;
2003-05-28 04:41:04 -04:00
}
2004-04-25 22:28:06 -04:00
}
2003-05-28 04:41:04 -04:00
2004-04-25 22:28:06 -04:00
// ==================================================================
// Turn error handling on or off..
2003-05-28 04:41:04 -04:00
2004-04-25 22:28:06 -04:00
function show_errors () {
$this -> show_errors = true ;
}
2006-02-12 02:53:23 -05:00
2004-04-25 22:28:06 -04:00
function hide_errors () {
$this -> show_errors = false ;
}
2003-05-28 04:41:04 -04:00
2004-04-25 22:28:06 -04:00
// ==================================================================
// Kill cached query results
2003-05-28 04:41:04 -04:00
2004-04-25 22:28:06 -04:00
function flush () {
2006-08-11 18:23:03 -04:00
$this -> last_result = array ();
2004-04-25 22:28:06 -04:00
$this -> col_info = null ;
$this -> last_query = null ;
}
2003-05-28 04:41:04 -04:00
2004-04-25 22:28:06 -04:00
// ==================================================================
// Basic Query - see docs for more detail
2003-05-28 04:41:04 -04:00
2004-04-25 22:28:06 -04:00
function query ( $query ) {
2006-12-06 19:02:03 -05:00
// filter the query, if filters are available
// NOTE: some queries are made before the plugins have been loaded, and thus cannot be filtered with this method
if ( function_exists ( 'apply_filters' ) )
$query = apply_filters ( 'query' , $query );
2004-04-25 22:54:06 -04:00
// initialise return
$return_val = 0 ;
2004-04-25 22:28:06 -04:00
$this -> flush ();
2003-05-28 04:41:04 -04:00
2004-04-25 22:28:06 -04:00
// Log how the function was called
$this -> func_call = " \$ db->query( \" $query\ " ) " ;
// Keep track of the last query for debug..
$this -> last_query = $query ;
// Perform the query via std mysql_query function..
2004-08-20 13:52:49 -04:00
if ( SAVEQUERIES )
$this -> timer_start ();
2006-02-12 02:53:23 -05:00
2004-08-20 13:52:49 -04:00
$this -> result = @ mysql_query ( $query , $this -> dbh );
2004-04-25 22:54:06 -04:00
++ $this -> num_queries ;
2007-02-27 10:24:54 -05:00
2004-08-20 13:52:49 -04:00
if ( SAVEQUERIES )
$this -> queries [] = array ( $query , $this -> timer_stop () );
2004-04-25 22:28:06 -04:00
2004-04-25 22:54:06 -04:00
// If there is an error then take note of it..
2007-01-15 21:32:42 -05:00
if ( mysql_error ( $this -> dbh ) ) {
2004-04-25 22:54:06 -04:00
$this -> print_error ();
return false ;
2004-04-25 22:28:06 -04:00
}
2003-05-28 04:41:04 -04:00
2004-04-25 22:54:06 -04:00
if ( preg_match ( " /^ \\ s*(insert|delete|update|replace) /i " , $query ) ) {
2007-04-06 13:22:53 -04:00
$this -> rows_affected = mysql_affected_rows ( $this -> dbh );
2004-04-25 22:54:06 -04:00
// Take note of the insert_id
if ( preg_match ( " /^ \\ s*(insert|replace) /i " , $query ) ) {
2006-02-12 02:53:23 -05:00
$this -> insert_id = mysql_insert_id ( $this -> dbh );
2004-04-25 22:54:06 -04:00
}
// Return number of rows affected
$return_val = $this -> rows_affected ;
2004-04-25 22:28:06 -04:00
} else {
2004-04-25 22:54:06 -04:00
$i = 0 ;
while ( $i < @ mysql_num_fields ( $this -> result )) {
$this -> col_info [ $i ] = @ mysql_fetch_field ( $this -> result );
$i ++ ;
}
$num_rows = 0 ;
while ( $row = @ mysql_fetch_object ( $this -> result ) ) {
$this -> last_result [ $num_rows ] = $row ;
$num_rows ++ ;
}
2003-05-28 04:41:04 -04:00
2004-04-25 22:54:06 -04:00
@ mysql_free_result ( $this -> result );
2003-05-28 04:41:04 -04:00
2004-04-25 22:54:06 -04:00
// Log number of rows the query returned
$this -> num_rows = $num_rows ;
2006-02-12 02:53:23 -05:00
2004-04-25 22:54:06 -04:00
// Return number of rows selected
$return_val = $this -> num_rows ;
}
2003-05-28 04:41:04 -04:00
2004-04-25 22:54:06 -04:00
return $return_val ;
2004-04-25 22:28:06 -04:00
}
2003-05-28 04:41:04 -04:00
2007-10-10 18:01:40 -04:00
/**
* Insert an array of data into a table
* @ param string $table WARNING : not sanitized !
* @ param array $data should not already be SQL - escaped
* @ return mixed results of $this -> query ()
*/
2007-10-12 20:54:26 -04:00
function insert ( $table , $data ) {
2007-10-10 18:01:40 -04:00
$data = add_magic_quotes ( $data );
$fields = array_keys ( $data );
return $this -> query ( " INSERT INTO $table (` " . implode ( '`,`' , $fields ) . " `) VALUES (' " . implode ( " ',' " , $data ) . " ') " );
}
/**
* Update a row in the table with an array of data
* @ param string $table WARNING : not sanitized !
* @ param array $data should not already be SQL - escaped
2007-10-12 21:44:25 -04:00
* @ param mixed $where_col_or_array if a string , it represents the column of the WHERE statement . If an array ( named ), it can represent multiple col = 'value' pairs that will be joined with ANDs WARNING : the column names are not sanitized !
2007-10-10 18:01:40 -04:00
* @ param string $where_val the value of the WHERE statement . Should not already be SQL - escaped .
* @ return mixed results of $this -> query ()
*/
2007-10-12 21:44:25 -04:00
function update ( $table , $data , $where_col_or_array , $where_val = NULL ){
2007-10-10 18:01:40 -04:00
$data = add_magic_quotes ( $data );
2007-10-12 21:44:25 -04:00
$bits = $wheres = array ();
2007-10-10 18:01:40 -04:00
foreach ( array_keys ( $data ) as $k )
2007-10-12 21:44:25 -04:00
$bits [] = " ` $k ` = ' $data[$k] ' " ;
if ( is_string ( $where_col_or_array ) )
$wheres = array ( " $where_col_or_array = ' " . $this -> escape ( $where_val ) . " ' " );
elseif ( is_array ( $where_col_or_array ) )
foreach ( $where_col_or_array as $c => $v )
$wheres [] = " $c = ' " . $this -> escape ( $v ) . " ' " ;
else
return false ;
return $this -> query ( " UPDATE $table SET " . implode ( ', ' , $bits ) . ' WHERE ' . implode ( ' AND ' , $wheres ) . ' LIMIT 1' );
2007-10-10 18:01:40 -04:00
}
2006-11-29 20:44:33 -05:00
/**
* Get one variable from the database
* @ param string $query ( can be null as well , for caching , see codex )
* @ param int $x = 0 row num to return
* @ param int $y = 0 col num to return
* @ return mixed results
*/
2004-04-25 22:54:06 -04:00
function get_var ( $query = null , $x = 0 , $y = 0 ) {
2004-04-25 22:28:06 -04:00
$this -> func_call = " \$ db->get_var( \" $query\ " , $x , $y ) " ;
2004-04-25 22:54:06 -04:00
if ( $query )
2004-04-25 22:28:06 -04:00
$this -> query ( $query );
2003-05-28 04:41:04 -04:00
2004-04-25 22:28:06 -04:00
// Extract var out of cached results based x,y vals
if ( $this -> last_result [ $y ] ) {
$values = array_values ( get_object_vars ( $this -> last_result [ $y ]));
2003-05-28 04:41:04 -04:00
}
2004-04-25 22:28:06 -04:00
// If there is a value return it else return null
return ( isset ( $values [ $x ]) && $values [ $x ] !== '' ) ? $values [ $x ] : null ;
}
2003-05-28 04:41:04 -04:00
2006-11-29 20:44:33 -05:00
/**
* Get one row from the database
* @ param string $query
* @ param string $output ARRAY_A | ARRAY_N | OBJECT
* @ param int $y row num to return
* @ return mixed results
*/
2004-04-25 22:54:06 -04:00
function get_row ( $query = null , $output = OBJECT , $y = 0 ) {
2004-04-25 22:28:06 -04:00
$this -> func_call = " \$ db->get_row( \" $query\ " , $output , $y ) " ;
2004-04-25 22:54:06 -04:00
if ( $query )
2004-04-25 22:28:06 -04:00
$this -> query ( $query );
2007-08-09 21:33:56 -04:00
else
return null ;
2007-06-13 22:25:30 -04:00
2006-09-22 10:40:40 -04:00
if ( ! isset ( $this -> last_result [ $y ]) )
return null ;
2003-05-28 04:41:04 -04:00
2004-04-25 22:28:06 -04:00
if ( $output == OBJECT ) {
2004-04-25 22:54:06 -04:00
return $this -> last_result [ $y ] ? $this -> last_result [ $y ] : null ;
} elseif ( $output == ARRAY_A ) {
return $this -> last_result [ $y ] ? get_object_vars ( $this -> last_result [ $y ]) : null ;
} elseif ( $output == ARRAY_N ) {
return $this -> last_result [ $y ] ? array_values ( get_object_vars ( $this -> last_result [ $y ])) : null ;
} else {
2004-04-25 22:28:06 -04:00
$this -> print_error ( " \$ db->get_row(string query, output type, int offset) -- Output type must be one of: OBJECT, ARRAY_A, ARRAY_N " );
2003-05-28 04:41:04 -04:00
}
2004-04-25 22:28:06 -04:00
}
2003-05-28 04:41:04 -04:00
2006-11-29 20:44:33 -05:00
/**
* Gets one column from the database
* @ param string $query ( can be null as well , for caching , see codex )
* @ param int $x col num to return
* @ return array results
*/
2004-04-25 22:54:06 -04:00
function get_col ( $query = null , $x = 0 ) {
if ( $query )
2004-04-25 22:28:06 -04:00
$this -> query ( $query );
2007-08-10 15:30:24 -04:00
2007-08-27 15:44:53 -04:00
$new_array = array ();
// Extract the column values
for ( $i = 0 ; $i < count ( $this -> last_result ); $i ++ ) {
$new_array [ $i ] = $this -> get_var ( null , $x , $i );
2004-04-25 22:28:06 -04:00
}
return $new_array ;
}
2003-05-28 04:41:04 -04:00
2006-11-29 20:44:33 -05:00
/**
* Return an entire result set from the database
* @ param string $query ( can also be null to pull from the cache )
* @ param string $output ARRAY_A | ARRAY_N | OBJECT
* @ return mixed results
*/
2004-04-25 22:54:06 -04:00
function get_results ( $query = null , $output = OBJECT ) {
2004-04-25 22:28:06 -04:00
$this -> func_call = " \$ db->get_results( \" $query\ " , $output ) " ;
2003-05-28 04:41:04 -04:00
2004-04-25 22:54:06 -04:00
if ( $query )
2004-04-25 22:28:06 -04:00
$this -> query ( $query );
2007-08-09 21:33:56 -04:00
else
return null ;
2003-05-28 04:41:04 -04:00
2004-04-25 22:28:06 -04:00
// Send back array of objects. Each row is an object
if ( $output == OBJECT ) {
return $this -> last_result ;
} elseif ( $output == ARRAY_A || $output == ARRAY_N ) {
if ( $this -> last_result ) {
2004-04-25 22:54:06 -04:00
$i = 0 ;
2004-04-25 22:28:06 -04:00
foreach ( $this -> last_result as $row ) {
$new_array [ $i ] = ( array ) $row ;
if ( $output == ARRAY_N ) {
$new_array [ $i ] = array_values ( $new_array [ $i ]);
2003-05-28 04:41:04 -04:00
}
2004-04-25 22:28:06 -04:00
$i ++ ;
2003-05-28 04:41:04 -04:00
}
2004-04-25 22:28:06 -04:00
return $new_array ;
} else {
return null ;
2003-05-28 04:41:04 -04:00
}
}
2004-04-25 22:28:06 -04:00
}
2003-05-28 04:41:04 -04:00
2006-11-29 20:44:33 -05:00
/**
* Grabs column metadata from the last query
* @ param string $info_type one of name , table , def , max_length , not_null , primary_key , multiple_key , unique_key , numeric , blob , type , unsigned , zerofill
* @ param int $col_offset 0 : col name . 1 : which table the col 's in. 2: col' s max length . 3 : if the col is numeric . 4 : col ' s type
* @ return mixed results
*/
2004-04-25 22:54:06 -04:00
function get_col_info ( $info_type = 'name' , $col_offset = - 1 ) {
2004-04-25 22:28:06 -04:00
if ( $this -> col_info ) {
if ( $col_offset == - 1 ) {
2004-04-25 22:54:06 -04:00
$i = 0 ;
2004-04-25 22:28:06 -04:00
foreach ( $this -> col_info as $col ) {
$new_array [ $i ] = $col -> { $info_type };
$i ++ ;
2003-05-28 04:41:04 -04:00
}
2004-04-25 22:28:06 -04:00
return $new_array ;
} else {
return $this -> col_info [ $col_offset ] -> { $info_type };
2003-05-28 04:41:04 -04:00
}
}
}
2004-07-22 21:35:56 -04:00
2006-11-29 20:44:33 -05:00
/**
* Starts the timer , for debugging purposes
*/
2004-08-20 13:52:49 -04:00
function timer_start () {
$mtime = microtime ();
$mtime = explode ( ' ' , $mtime );
$this -> time_start = $mtime [ 1 ] + $mtime [ 0 ];
return true ;
2004-07-22 21:35:56 -04:00
}
2006-02-12 02:53:23 -05:00
2006-11-29 20:44:33 -05:00
/**
* Stops the debugging timer
* @ return int total time spent on the query , in milliseconds
*/
function timer_stop () {
2004-08-20 13:52:49 -04:00
$mtime = microtime ();
$mtime = explode ( ' ' , $mtime );
$time_end = $mtime [ 1 ] + $mtime [ 0 ];
$time_total = $time_end - $this -> time_start ;
2004-08-20 13:56:51 -04:00
return $time_total ;
2004-07-22 21:35:56 -04:00
}
2006-11-29 20:44:33 -05:00
/**
* Wraps fatal errors in a nice header and footer and dies .
* @ param string $message
*/
2004-08-20 13:52:49 -04:00
function bail ( $message ) { // Just wraps errors in a nice header and footer
2006-07-10 01:29:10 -04:00
if ( ! $this -> show_errors )
return false ;
2007-09-13 02:23:23 -04:00
wp_die ( $message );
2004-07-22 21:35:56 -04:00
}
2007-10-06 04:40:54 -04:00
/**
* Checks wether of not the database version is high enough to support the features WordPress uses
* @ global $wp_version
*/
function check_database_version ()
{
global $wp_version ;
// Make sure the server has MySQL 4.0
$mysql_version = preg_replace ( '|[^0-9\.]|' , '' , @ mysql_get_server_info ());
if ( version_compare ( $mysql_version , '4.0.0' , '<' ) )
return new WP_Error ( 'database_version' , sprintf ( __ ( '<strong>ERROR</strong>: WordPress %s requires MySQL 4.0.0 or higher' ), $wp_version ));
}
/**
* This function is called when WordPress is generating the table schema to determine wether or not the current database
* supports or needs the collation statements .
*/
function supports_collation ()
{
return ( version_compare ( mysql_get_server_info (), '4.1.0' , '>=' ) );
}
2004-04-25 22:28:06 -04:00
}
2006-09-01 14:44:13 -04:00
if ( ! isset ( $wpdb ) )
$wpdb = new wpdb ( DB_USER , DB_PASSWORD , DB_NAME , DB_HOST );
2007-10-06 04:40:54 -04:00
?>