diff --git a/database/updates.inc b/database/updates.inc index bb73e7235bb..1b7ae8f2d63 100644 --- a/database/updates.inc +++ b/database/updates.inc @@ -4,6 +4,27 @@ /** * @file * All incremental database updates performed between Drupal releases. + * + * For all updates after 147, please use the following syntax: + * + * function update_N() { + * $ret = array(); + * + * switch ($GLOBALS['db_type']) { + * case 'pgsql': + * // PostgreSQL code goes here + * break; + * case 'mysql': + * case 'mysqli': + * // MySQL code goes here + * break; + * default: + * break; + * } + * + * return $ret; + * } + * */ // Define the various updates in an array("date : comment" => "function"); diff --git a/includes/database.inc b/includes/database.inc index 0fe82d2471e..5315e66ec52 100644 --- a/includes/database.inc +++ b/includes/database.inc @@ -118,7 +118,7 @@ function db_set_active($name = 'default') { else { drupal_maintenance_theme(); drupal_set_title('Unsupported database type'); - print theme('maintenance_page', '

The database type '. theme('placeholder', $db_type) .' is unsupported. Please use either mysql for MySQL databases or pgsql for PostgreSQL databases. The database information is in your settings.php file.

+ print theme('maintenance_page', '

The database type '. theme('placeholder', $db_type) .' is unsupported. Please use either mysql for MySQL 3.x & 4.0.x databases, mysqli for MySQL 4.1.x+ databases, or pgsql for PostgreSQL databases. The database information is in your settings.php file.

For more help, see the Installation and upgrading handbook. If you are unsure what these terms mean you should probably contact your hosting provider.

'); exit; } diff --git a/includes/database.mysqli.inc b/includes/database.mysqli.inc new file mode 100644 index 00000000000..f77709cf253 --- /dev/null +++ b/includes/database.mysqli.inc @@ -0,0 +1,290 @@ +This either means that the username and password information in your settings.php file is incorrect or we can\'t contact the MySQL database server through the mysqli libraries. This could mean your hosting provider\'s database server is down, or your PHP is not compiled with mysqli.

+

The MySQL error was: '. theme('placeholder', mysqli_error($connection)) .'.

+

Currently, the username is '. theme('placeholder', $url['user']) .' and the database server is '. theme('placeholder', $url['host']) .'.

+ +

For more help, see the Installation and upgrading handbook. If you are unsure what these terms mean you should probably contact your hosting provider.

'); + exit; + } + + if (!mysqli_select_db($connection, substr($url['path'], 1))) { + drupal_maintenance_theme(); + drupal_set_title('Unable to select database'); + print theme('maintenance_page', '

We were able to connect to the MySQL database server (which means your username and password are okay) but not able to select the database.

+

The MySQL error was: '. theme('placeholder', mysqli_error($connection)) .'.

+

Currently, the database is '. theme('placeholder', substr($url['path'], 1)) .'. The username is '. theme('placeholder', $url['user']) .' and the database server is '. theme('placeholder', $url['host']) .'.

+ +

For more help, see the Installation and upgrading handbook. If you are unsure what these terms mean you should probably contact your hosting provider.

'); + exit; + } + + return $connection; +} + +/** + * Helper function for db_query(). + */ +function _db_query($query, $debug = 0) { + global $active_db, $queries; + + if (variable_get('dev_query', 0)) { + list($usec, $sec) = explode(' ', microtime()); + $timer = (float)$usec + (float)$sec; + } + + $result = mysqli_query($active_db, $query); + + if (variable_get('dev_query', 0)) { + list($usec, $sec) = explode(' ', microtime()); + $stop = (float)$usec + (float)$sec; + $diff = $stop - $timer; + $queries[] = array($query, $diff); + } + + if ($debug) { + print '

query: '. $query .'
error:'. mysqli_error($active_db) .'

'; + } + + if (!mysqli_errno($active_db)) { + return $result; + } + else { + trigger_error(mysqli_error($active_db) ."\nquery: ". htmlspecialchars($query), E_USER_ERROR); + return FALSE; + } +} + +/** + * Fetch one result row from the previous query as an object. + * + * @param $result + * A database query result resource, as returned from db_query(). + * @return + * An object representing the next row of the result. The attributes of this + * object are the table fields selected by the query. + */ +function db_fetch_object($result) { + if ($result) { + return mysqli_fetch_object($result); + } +} + +/** + * Fetch one result row from the previous query as an array. + * + * @param $result + * A database query result resource, as returned from db_query(). + * @return + * An associative array representing the next row of the result. The keys of + * this object are the names of the table fields selected by the query, and + * the values are the field values for this result row. + */ +function db_fetch_array($result) { + if ($result) { + return mysqli_fetch_array($result, MYSQLI_ASSOC); + } +} + +/** + * Determine how many result rows were found by the preceding query. + * + * @param $result + * A database query result resource, as returned from db_query(). + * @return + * The number of result rows. + */ +function db_num_rows($result) { + if ($result) { + return mysqli_num_rows($result); + } +} + +/** +* Return an individual result field from the previous query. +* +* Only use this function if exactly one field is being selected; otherwise, +* use db_fetch_object() or db_fetch_array(). +* +* @param $result +* A database query result resource, as returned from db_query(). +* @param $row +* The index of the row whose result is needed. +* @return +* The resulting field. +*/ +function db_result($result, $row = 0) { + if ($result && mysqli_num_rows($result) > $row) { + $array = mysqli_fetch_array($result, MYSQLI_NUM); + return $array[0]; + } +} + +/** + * Determine whether the previous query caused an error. + */ +function db_error() { + global $active_db; + return mysqli_errno($active_db); +} + +/** + * Return a new unique ID in the given sequence. + * + * For compatibility reasons, Drupal does not use auto-numbered fields in its + * database tables. Instead, this function is used to return a new unique ID + * of the type requested. If necessary, a new sequence with the given name + * will be created. + */ +function db_next_id($name) { + $name = db_prefix_tables($name); + db_query('LOCK TABLES {sequences} WRITE'); + $id = db_result(db_query("SELECT id FROM {sequences} WHERE name = '%s'", $name)) + 1; + db_query("REPLACE INTO {sequences} VALUES ('%s', %d)", $name, $id); + db_query('UNLOCK TABLES'); + + return $id; +} + +/** + * Determine the number of rows changed by the preceding query. + */ +function db_affected_rows() { + global $active_db; /* mysqli connection resource */ + return mysqli_affected_rows($active_db); +} + +/** + * Runs a limited-range query in the active database. + * + * Use this as a substitute for db_query() when a subset of the query is to be + * returned. + * User-supplied arguments to the query should be passed in as separate parameters + * so that they can be properly escaped to avoid SQL injection attacks. + * + * @param $query + * A string containing an SQL query. + * @param ... + * A variable number of arguments which are substituted into the query using + * printf() syntax. Instead of a variable number of query arguments, you may + * also pass a single array containing the query arguments. + * @param $from + * The first result row to return. + * @param $count + * The maximum number of result rows to return. + * @return + * A database query result resource, or FALSE if the query was not executed + * correctly. + */ +function db_query_range($query) { + $args = func_get_args(); + $count = array_pop($args); + $from = array_pop($args); + + $query = db_prefix_tables($query); + if (count($args) > 1) { + // Check for array (alternative syntax). + if (is_array($args[1])) { + $args = array_merge(array($query), $args[1]); + } + $args = array_map('db_escape_string', $args); + $args[0] = $query; + $query = call_user_func_array('sprintf', $args); + } + $query .= ' LIMIT '. $from .', '. $count; + return _db_query($query); +} + +/** + * Returns a properly formatted Binary Large OBject value. + * + * @param $data + * Data to encode. + * @return + * Encoded data. + */ +function db_encode_blob($data) { + return $data; +} + +/** + * Returns text from a Binary Large OBject value. + * + * @param $data + * Data to decode. + * @return + * Decoded data. + */ +function db_decode_blob($data) { + return $data; +} + +/** + * Prepare user input for use in a database query, preventing SQL injection attacks. + */ +function db_escape_string($text) { + return addslashes($text); +} + + +/** + * Lock a table. + */ +function db_lock_table($table) { + db_query('LOCK TABLES {%s} WRITE', $table); +} + +/** + * Unlock all locked tables. + */ +function db_unlock_tables() { + db_query('UNLOCK TABLES'); +} + +/** + * @} End of "ingroup database". + */ + diff --git a/sites/default/settings.php b/sites/default/settings.php index 2e4edca4232..610ef05ee85 100644 --- a/sites/default/settings.php +++ b/sites/default/settings.php @@ -76,6 +76,7 @@ * * Database URL format: * $db_url = 'mysql://username:password@localhost/database'; + * $db_url = 'mysqli://username:password@localhost/database'; * $db_url = 'pgsql://username:password@localhost/database'; */ $db_url = 'mysql://username:password@localhost/database';