write; 0 => read * * @var int */ protected $last_query_type = 0; /** * Connect to the database server. * * @param array $config Array of DBMS connection details. * @return mysqli The DB connection resource. Returns false on fail or -1 on a db connect failure. */ function connect($config) { // Simple connection to one server if(array_key_exists('hostname', $config)) { $connections['read'][] = $config; } else // Connecting to more than one server { // Specified multiple servers, but no specific read/write servers if(!array_key_exists('read', $config)) { foreach($config as $key => $settings) { if(is_int($key)) { $connections['read'][] = $settings; } } } // Specified both read & write servers else { $connections = $config; } } $this->db_encoding = $config['encoding']; // Actually connect to the specified servers foreach(array('read', 'write') as $type) { if(!isset($connections[$type]) || !is_array($connections[$type])) { break; } if(array_key_exists('hostname', $connections[$type])) { $details = $connections[$type]; unset($connections); $connections[$type][] = $details; } // Shuffle the connections shuffle($connections[$type]); // Loop-de-loop foreach($connections[$type] as $single_connection) { $connect_function = "mysqli_connect"; $persist = ""; if(!empty($single_connection['pconnect']) && version_compare(PHP_VERSION, '5.3.0', '>=')) { $persist = 'p:'; } $link = "{$type}_link"; get_execution_time(); // Specified a custom port for this connection? $port = 0; if(strstr($single_connection['hostname'],':')) { list($hostname, $port) = explode(":", $single_connection['hostname'], 2); } if($port) { $this->$link = @$connect_function($persist.$hostname, $single_connection['username'], $single_connection['password'], "", $port); } else { $this->$link = @$connect_function($persist.$single_connection['hostname'], $single_connection['username'], $single_connection['password']); } $time_spent = get_execution_time(); $this->query_time += $time_spent; // Successful connection? break down brother! if($this->$link) { $this->connections[] = "[".strtoupper($type)."] {$single_connection['username']}@{$single_connection['hostname']} (Connected in ".format_time_duration($time_spent).")"; break; } else { $this->connections[] = "[FAILED] [".strtoupper($type)."] {$single_connection['username']}@{$single_connection['hostname']}"; } } } // No write server was specified (simple connection or just multiple servers) - mirror write link if(!array_key_exists('write', $connections)) { $this->write_link = &$this->read_link; } // Have no read connection? if(!$this->read_link) { $this->error("[READ] Unable to connect to MySQL server"); return false; } // No write? else if(!$this->write_link) { $this->error("[WRITE] Unable to connect to MySQL server"); return false; } // Select databases if(!$this->select_db($config['database'])) { return -1; } $this->current_link = &$this->read_link; return $this->read_link; } /** * Selects the database to use. * * @param string $database The database name. * @return boolean True when successfully connected, false if not. */ function select_db($database) { $this->database = $database; $master_success = @mysqli_select_db($this->read_link, $database) or $this->error("[READ] Unable to select database", $this->read_link); if($this->write_link) { $slave_success = @mysqli_select_db($this->write_link, $database) or $this->error("[WRITE] Unable to select slave database", $this->write_link); $success = ($master_success && $slave_success ? true : false); } else { $success = $master_success; } if($success && $this->db_encoding) { @mysqli_set_charset($this->read_link, $this->db_encoding); if($slave_success && count($this->connections) > 1) { @mysqli_set_charset($this->write_link, $this->db_encoding); } } return $success; } /** * Query the database. * * @param string $string The query SQL. * @param boolean|int $hide_errors 1 if hide errors, 0 if not. * @param integer $write_query 1 if executes on master database, 0 if not. * @return mysqli_result The query data. */ function query($string, $hide_errors=0, $write_query=0) { global $mybb; get_execution_time(); // Only execute write queries on master server if(($write_query || $this->last_query_type) && $this->write_link) { $this->current_link = &$this->write_link; $query = @mysqli_query($this->write_link, $string); } else { $this->current_link = &$this->read_link; $query = @mysqli_query($this->read_link, $string); } if($this->error_number() && !$hide_errors) { $this->error($string); exit; } if($write_query) { $this->last_query_type = 1; } else { $this->last_query_type = 0; } $query_time = get_execution_time(); $this->query_time += $query_time; $this->query_count++; if($mybb->debug_mode) { $this->explain_query($string, $query_time); } return $query; } /** * Execute a write query on the master database * * @param string $query The query SQL. * @param boolean|int $hide_errors 1 if hide errors, 0 if not. * @return mysqli_result The query data. */ function write_query($query, $hide_errors=0) { return $this->query($query, $hide_errors, 1); } /** * Explain a query on the database. * * @param string $string The query SQL. * @param string $qtime The time it took to perform the query. */ function explain_query($string, $qtime) { global $plugins; $debug_extra = ''; if($plugins->current_hook) { $debug_extra = "
(Plugin Hook: {$plugins->current_hook})
"; } if(preg_match("#^\s*select#i", $string)) { $query = mysqli_query($this->current_link, "EXPLAIN $string"); $this->explain .= "\n". "\n". "\n". "\n". "\n". "\n". "\n". "\n". "\n". "\n". "\n". "\n". "\n". "\n". "\n". "\n". "\n"; while($table = mysqli_fetch_assoc($query)) { $this->explain .= "\n". "\n". "\n". "\n". "\n". "\n". "\n". "\n". "\n". "\n"; } $this->explain .= "\n". "\n". "\n". "
{$debug_extra}
#".$this->query_count." - Select Query
".htmlspecialchars_uni($string)."
TableTypePossible KeysKeyKey LengthRefRowsExtra
".$table['table']."".$table['type']."".$table['possible_keys']."".$table['key']."".$table['key_len']."".$table['ref']."".$table['rows']."".$table['Extra']."
Query Time: ".format_time_duration($qtime)."
\n". "
\n"; } else { $this->explain .= "\n". "\n". "\n". "\n". "\n". "\n". "\n". "\n". "\n". "\n". "
{$debug_extra}
#".$this->query_count." - Write Query
".htmlspecialchars_uni($string)."
Query Time: ".format_time_duration($qtime)."
\n". "
\n"; } $this->querylist[$this->query_count]['query'] = $string; $this->querylist[$this->query_count]['time'] = $qtime; } /** * Return a result array for a query. * * @param mysqli_result $query The query data. * @param int $resulttype The type of array to return. Either MYSQLI_NUM, MYSQLI_BOTH or MYSQLI_ASSOC * @return array The array of results. */ function fetch_array($query, $resulttype=MYSQLI_ASSOC) { switch($resulttype) { case MYSQLI_NUM: case MYSQLI_BOTH: break; default: $resulttype = MYSQLI_ASSOC; break; } $array = mysqli_fetch_array($query, $resulttype); return $array; } /** * Return a specific field from a query. * * @param mysqli_result $query The query ID. * @param string $field The name of the field to return. * @param int|bool $row The number of the row to fetch it from. */ function fetch_field($query, $field, $row=false) { if($row !== false) { $this->data_seek($query, $row); } $array = $this->fetch_array($query); return $array[$field]; } /** * Moves internal row pointer to the next row * * @param mysqli_result $query The query ID. * @param int $row The pointer to move the row to. * @return bool */ function data_seek($query, $row) { return mysqli_data_seek($query, $row); } /** * Return the number of rows resulting from a query. * * @param mysqli_result $query The query data. * @return int The number of rows in the result. */ function num_rows($query) { return mysqli_num_rows($query); } /** * Return the last id number of inserted data. * * @return int The id number. */ function insert_id() { $id = mysqli_insert_id($this->current_link); return $id; } /** * Close the connection with the DBMS. * */ function close() { @mysqli_close($this->read_link); if($this->write_link) { @mysqli_close($this->write_link); } } /** * Return an error number. * * @return int The error number of the current error. */ function error_number() { if($this->current_link) { return mysqli_errno($this->current_link); } else { return mysqli_connect_errno(); } } /** * Return an error string. * * @return string The explanation for the current error. */ function error_string() { if($this->current_link) { return mysqli_error($this->current_link); } else { return mysqli_connect_error(); } } /** * Output a database error. * * @param string $string The string to present as an error. * @return bool Whether error reporting is enabled or not */ function error($string="") { if($this->error_reporting) { if(class_exists("errorHandler")) { global $error_handler; if(!is_object($error_handler)) { require_once MYBB_ROOT."inc/class_error.php"; $error_handler = new errorHandler(); } $error = array( "error_no" => $this->error_number(), "error" => $this->error_string(), "query" => $string ); $error_handler->error(MYBB_SQL, $error); } else { trigger_error("[SQL] [".$this->error_number()."] ".$this->error_string()."
{$string}", E_USER_ERROR); } return true; } else { return false; } } /** * Returns the number of affected rows in a query. * * @return int The number of affected rows. */ function affected_rows() { return mysqli_affected_rows($this->current_link); } /** * Return the number of fields. * * @param mysqli_result $query The query data. * @return int The number of fields. */ function num_fields($query) { return mysqli_num_fields($query); } /** * Lists all tables in the database. * * @param string $database The database name. * @param string $prefix Prefix of the table (optional) * @return array The table list. */ function list_tables($database, $prefix='') { if($prefix) { if(version_compare($this->get_version(), '5.0.2', '>=')) { $query = $this->query("SHOW FULL TABLES FROM `$database` WHERE table_type = 'BASE TABLE' AND `Tables_in_$database` LIKE '".$this->escape_string($prefix)."%'"); } else { $query = $this->query("SHOW TABLES FROM `$database` LIKE '".$this->escape_string($prefix)."%'"); } } else { if(version_compare($this->get_version(), '5.0.2', '>=')) { $query = $this->query("SHOW FULL TABLES FROM `$database` WHERE table_type = 'BASE TABLE'"); } else { $query = $this->query("SHOW TABLES FROM `$database`"); } } $tables = array(); while(list($table) = mysqli_fetch_array($query)) { $tables[] = $table; } return $tables; } /** * Check if a table exists in a database. * * @param string $table The table name. * @return boolean True when exists, false if not. */ function table_exists($table) { // Execute on master server to ensure if we've just created a table that we get the correct result if(version_compare($this->get_version(), '5.0.2', '>=')) { $query = $this->query("SHOW FULL TABLES FROM `".$this->database."` WHERE table_type = 'BASE TABLE' AND `Tables_in_".$this->database."` = '{$this->table_prefix}$table'"); } else { $query = $this->query("SHOW TABLES LIKE '{$this->table_prefix}$table'"); } $exists = $this->num_rows($query); if($exists > 0) { return true; } else { return false; } } /** * Check if a field exists in a database. * * @param string $field The field name. * @param string $table The table name. * @return boolean True when exists, false if not. */ function field_exists($field, $table) { $query = $this->write_query(" SHOW COLUMNS FROM {$this->table_prefix}$table LIKE '$field' "); $exists = $this->num_rows($query); if($exists > 0) { return true; } else { return false; } } /** * Add a shutdown query. * * @param mysqli_result $query The query data. * @param string $name An optional name for the query. */ function shutdown_query($query, $name="") { global $shutdown_queries; if($name) { $shutdown_queries[$name] = $query; } else { $shutdown_queries[] = $query; } } /** * Performs a simple select query. * * @param string $table The table name to be queried. * @param string $fields Comma delimetered list of fields to be selected. * @param string $conditions SQL formatted list of conditions to be matched. * @param array $options List of options: group by, order by, order direction, limit, limit start. * @return mysqli_result The query data. */ function simple_select($table, $fields="*", $conditions="", $options=array()) { $query = "SELECT ".$fields." FROM ".$this->table_prefix.$table; if($conditions != "") { $query .= " WHERE ".$conditions; } if(isset($options['group_by'])) { $query .= " GROUP BY ".$options['group_by']; } if(isset($options['order_by'])) { $query .= " ORDER BY ".$options['order_by']; if(isset($options['order_dir'])) { $query .= " ".my_strtoupper($options['order_dir']); } } if(isset($options['limit_start']) && isset($options['limit'])) { $query .= " LIMIT ".$options['limit_start'].", ".$options['limit']; } else if(isset($options['limit'])) { $query .= " LIMIT ".$options['limit']; } return $this->query($query); } /** * Build an insert query from an array. * * @param string $table The table name to perform the query on. * @param array $array An array of fields and their values. * @return int The insert ID if available */ function insert_query($table, $array) { global $mybb; if(!is_array($array)) { return false; } foreach($array as $field => $value) { if(isset($mybb->binary_fields[$table][$field]) && $mybb->binary_fields[$table][$field]) { if($value[0] != 'X') // Not escaped? { $value = $this->escape_binary($value); } $array[$field] = $value; } else { $array[$field] = $this->quote_val($value); } } $fields = "`".implode("`,`", array_keys($array))."`"; $values = implode(",", $array); $this->write_query(" INSERT INTO {$this->table_prefix}{$table} (".$fields.") VALUES (".$values.") "); return $this->insert_id(); } /** * Build one query for multiple inserts from a multidimensional array. * * @param string $table The table name to perform the query on. * @param array $array An array of inserts. * @return void */ function insert_query_multiple($table, $array) { global $mybb; if(!is_array($array)) { return; } // Field names $fields = array_keys($array[0]); $fields = "`".implode("`,`", $fields)."`"; $insert_rows = array(); foreach($array as $values) { foreach($values as $field => $value) { if(isset($mybb->binary_fields[$table][$field]) && $mybb->binary_fields[$table][$field]) { if($value[0] != 'X') // Not escaped? { $value = $this->escape_binary($value); } $values[$field] = $value; } else { $values[$field] = $this->quote_val($value); } } $insert_rows[] = "(".implode(",", $values).")"; } $insert_rows = implode(", ", $insert_rows); $this->write_query(" INSERT INTO {$this->table_prefix}{$table} ({$fields}) VALUES {$insert_rows} "); } /** * Build an update query from an array. * * @param string $table The table name to perform the query on. * @param array $array An array of fields and their values. * @param string $where An optional where clause for the query. * @param string $limit An optional limit clause for the query. * @param boolean $no_quote An option to quote incoming values of the array. * @return mysqli_result The query data. */ function update_query($table, $array, $where="", $limit="", $no_quote=false) { global $mybb; if(!is_array($array)) { return false; } $comma = ""; $query = ""; $quote = "'"; if($no_quote == true) { $quote = ""; } foreach($array as $field => $value) { if(isset($mybb->binary_fields[$table][$field]) && $mybb->binary_fields[$table][$field]) { if($value[0] != 'X') // Not escaped? { $value = $this->escape_binary($value); } $query .= $comma."`".$field."`={$value}"; } else { $quoted_value = $this->quote_val($value, $quote); $query .= $comma."`".$field."`={$quoted_value}"; } $comma = ', '; } if(!empty($where)) { $query .= " WHERE $where"; } if(!empty($limit)) { $query .= " LIMIT $limit"; } return $this->write_query(" UPDATE {$this->table_prefix}$table SET $query "); } /** * @param int|string $value * @param string $quote * * @return int|string */ private function quote_val($value, $quote="'") { if(is_int($value)) { $quoted = $value; } else { $quoted = $quote . $value . $quote; } return $quoted; } /** * Build a delete query. * * @param string $table The table name to perform the query on. * @param string $where An optional where clause for the query. * @param string $limit An optional limit clause for the query. * @return mysqli_result The query data. */ function delete_query($table, $where="", $limit="") { $query = ""; if(!empty($where)) { $query .= " WHERE $where"; } if(!empty($limit)) { $query .= " LIMIT $limit"; } return $this->write_query("DELETE FROM {$this->table_prefix}$table $query"); } /** * Escape a string according to the MySQL escape format. * * @param string $string The string to be escaped. * @return string The escaped string. */ function escape_string($string) { if($this->db_encoding == 'utf8') { $string = validate_utf8_string($string, false); } elseif($this->db_encoding == 'utf8mb4') { $string = validate_utf8_string($string); } if(function_exists("mysqli_real_escape_string") && $this->read_link) { $string = mysqli_real_escape_string($this->read_link, $string); } else { $string = addslashes($string); } return $string; } /** * Frees the resources of a MySQLi query. * * @param mysqli_result $query The query to destroy. * @return boolean Returns true */ function free_result($query) { mysqli_free_result($query); return true; // Kept for compatibility reasons } /** * Escape a string used within a like command. * * @param string $string The string to be escaped. * @return string The escaped string. */ function escape_string_like($string) { return $this->escape_string(str_replace(array('%', '_') , array('\\%' , '\\_') , $string)); } /** * Gets the current version of MySQL. * * @return string Version of MySQL. */ function get_version() { if($this->version) { return $this->version; } $version = @mysqli_get_server_info($this->read_link); if(!$version) { $query = $this->query("SELECT VERSION() as version"); $ver = $this->fetch_array($query); $version = $ver['version']; } if($version) { $version = explode(".", $version, 3); $this->version = (int)$version[0].".".(int)$version[1].".".(int)$version[2]; } return $this->version; } /** * Optimizes a specific table. * * @param string $table The name of the table to be optimized. */ function optimize_table($table) { $this->write_query("OPTIMIZE TABLE ".$this->table_prefix.$table.""); } /** * Analyzes a specific table. * * @param string $table The name of the table to be analyzed. */ function analyze_table($table) { $this->write_query("ANALYZE TABLE ".$this->table_prefix.$table.""); } /** * Show the "create table" command for a specific table. * * @param string $table The name of the table. * @return string The MySQL command to create the specified table. */ function show_create_table($table) { $query = $this->write_query("SHOW CREATE TABLE ".$this->table_prefix.$table.""); $structure = $this->fetch_array($query); return $structure['Create Table']; } /** * Show the "show fields from" command for a specific table. * * @param string $table The name of the table. * @return array Field info for that table */ function show_fields_from($table) { $query = $this->write_query("SHOW FIELDS FROM ".$this->table_prefix.$table.""); $field_info = array(); while($field = $this->fetch_array($query)) { $field_info[] = $field; } return $field_info; } /** * Returns whether or not the table contains a fulltext index. * * @param string $table The name of the table. * @param string $index Optionally specify the name of the index. * @return boolean True or false if the table has a fulltext index or not. */ function is_fulltext($table, $index="") { $structure = $this->show_create_table($table); if($index != "") { if(preg_match("#FULLTEXT KEY (`?)$index(`?)#i", $structure)) { return true; } else { return false; } } if(preg_match('#FULLTEXT KEY#i', $structure)) { return true; } return false; } /** * Returns whether or not this database engine supports fulltext indexing. * * @param string $table The table to be checked. * @return boolean True or false if supported or not. */ function supports_fulltext($table) { $version = $this->get_version(); $query = $this->write_query("SHOW TABLE STATUS LIKE '{$this->table_prefix}$table'"); $status = $this->fetch_array($query); $table_type = my_strtoupper($status['Engine']); if(version_compare($version, '3.23.23', '>=') && ($table_type == 'MYISAM' || $table_type == 'ARIA')) { return true; } elseif(version_compare($version, '5.6', '>=') && $table_type == 'INNODB') { return true; } return false; } /** * Returns whether or not this database engine supports boolean fulltext matching. * * @param string $table The table to be checked. * @return boolean True or false if supported or not. */ function supports_fulltext_boolean($table) { $version = $this->get_version(); $supports_fulltext = $this->supports_fulltext($table); if(version_compare($version, '4.0.1', '>=') && $supports_fulltext == true) { return true; } return false; } /** * Checks to see if an index exists on a specified table * * @param string $table The name of the table. * @param string $index The name of the index. * @return bool Returns whether index exists */ function index_exists($table, $index) { $index_exists = false; $query = $this->write_query("SHOW INDEX FROM {$this->table_prefix}{$table}"); while($ukey = $this->fetch_array($query)) { if($ukey['Key_name'] == $index) { $index_exists = true; break; } } if($index_exists) { return true; } return false; } /** * Creates a fulltext index on the specified column in the specified table with optional index name. * * @param string $table The name of the table. * @param string $column Name of the column to be indexed. * @param string $name The index name, optional. */ function create_fulltext_index($table, $column, $name="") { $this->write_query("ALTER TABLE {$this->table_prefix}$table ADD FULLTEXT $name ($column)"); } /** * Drop an index with the specified name from the specified table * * @param string $table The name of the table. * @param string $name The name of the index. */ function drop_index($table, $name) { $this->write_query("ALTER TABLE {$this->table_prefix}$table DROP INDEX $name"); } /** * Drop an table with the specified table * * @param string $table The table to drop * @param boolean $hard hard drop - no checking * @param boolean $table_prefix use table prefix */ function drop_table($table, $hard=false, $table_prefix=true) { if($table_prefix == false) { $table_prefix = ""; } else { $table_prefix = $this->table_prefix; } if($hard == false) { $this->write_query('DROP TABLE IF EXISTS '.$table_prefix.$table); } else { $this->write_query('DROP TABLE '.$table_prefix.$table); } } /** * Renames a table * * @param string $old_table The old table name * @param string $new_table the new table name * @param boolean $table_prefix use table prefix * @return mysqli_result */ function rename_table($old_table, $new_table, $table_prefix=true) { if($table_prefix == false) { $table_prefix = ""; } else { $table_prefix = $this->table_prefix; } return $this->write_query("RENAME TABLE {$table_prefix}{$old_table} TO {$table_prefix}{$new_table}"); } /** * Replace contents of table with values * * @param string $table The table * @param array $replacements The replacements * @return mysqli_result|bool */ function replace_query($table, $replacements=array()) { global $mybb; $values = ''; $comma = ''; foreach($replacements as $column => $value) { if(isset($mybb->binary_fields[$table][$column]) && $mybb->binary_fields[$table][$column]) { if($value[0] != 'X') // Not escaped? { $value = $this->escape_binary($value); } $values .= $comma."`".$column."`=".$value; } else { $values .= $comma."`".$column."`=".$this->quote_val($value); } $comma = ','; } if(empty($replacements)) { return false; } return $this->write_query("REPLACE INTO {$this->table_prefix}{$table} SET {$values}"); } /** * Drops a column * * @param string $table The table * @param string $column The column name * @return mysqli_result */ function drop_column($table, $column) { return $this->write_query("ALTER TABLE {$this->table_prefix}{$table} DROP {$column}"); } /** * Adds a column * * @param string $table The table * @param string $column The column name * @param string $definition the new column definition * @return mysqli_result */ function add_column($table, $column, $definition) { return $this->write_query("ALTER TABLE {$this->table_prefix}{$table} ADD {$column} {$definition}"); } /** * Modifies a column * * @param string $table The table * @param string $column The column name * @param string $new_definition the new column definition * @return mysqli_result */ function modify_column($table, $column, $new_definition) { return $this->write_query("ALTER TABLE {$this->table_prefix}{$table} MODIFY {$column} {$new_definition}"); } /** * Renames a column * * @param string $table The table * @param string $old_column The old column name * @param string $new_column the new column name * @param string $new_definition the new column definition * @return mysqli_result */ function rename_column($table, $old_column, $new_column, $new_definition) { return $this->write_query("ALTER TABLE {$this->table_prefix}{$table} CHANGE {$old_column} {$new_column} {$new_definition}"); } /** * Sets the table prefix used by the simple select, insert, update and delete functions * * @param string $prefix The new table prefix */ function set_table_prefix($prefix) { $this->table_prefix = $prefix; } /** * Fetched the total size of all mysql tables or a specific table * * @param string $table The table (optional) * @return integer the total size of all mysql tables or a specific table */ function fetch_size($table='') { if($table != '') { $query = $this->query("SHOW TABLE STATUS LIKE '".$this->table_prefix.$table."'"); } else { $query = $this->query("SHOW TABLE STATUS"); } $total = 0; while($table = $this->fetch_array($query)) { $total += $table['Data_length']+$table['Index_length']; } return $total; } /** * Fetch a list of database character sets this DBMS supports * * @return array|bool Array of supported character sets with array key being the name, array value being display name. False if unsupported */ function fetch_db_charsets() { if($this->write_link && version_compare($this->get_version(), "4.1", "<")) { return false; } return array( 'big5' => 'Big5 Traditional Chinese', 'dec8' => 'DEC West European', 'cp850' => 'DOS West European', 'hp8' => 'HP West European', 'koi8r' => 'KOI8-R Relcom Russian', 'latin1' => 'ISO 8859-1 Latin 1', 'latin2' => 'ISO 8859-2 Central European', 'swe7' => '7bit Swedish', 'ascii' => 'US ASCII', 'ujis' => 'EUC-JP Japanese', 'sjis' => 'Shift-JIS Japanese', 'hebrew' => 'ISO 8859-8 Hebrew', 'tis620' => 'TIS620 Thai', 'euckr' => 'EUC-KR Korean', 'koi8u' => 'KOI8-U Ukrainian', 'gb2312' => 'GB2312 Simplified Chinese', 'greek' => 'ISO 8859-7 Greek', 'cp1250' => 'Windows Central European', 'gbk' => 'GBK Simplified Chinese', 'latin5' => 'ISO 8859-9 Turkish', 'armscii8' => 'ARMSCII-8 Armenian', 'utf8' => 'UTF-8 Unicode', 'utf8mb4' => '4-Byte UTF-8 Unicode (requires MySQL 5.5.3 or above)', 'ucs2' => 'UCS-2 Unicode', 'cp866' => 'DOS Russian', 'keybcs2' => 'DOS Kamenicky Czech-Slovak', 'macce' => 'Mac Central European', 'macroman' => 'Mac West European', 'cp852' => 'DOS Central European', 'latin7' => 'ISO 8859-13 Baltic', 'cp1251' => 'Windows Cyrillic', 'cp1256' => 'Windows Arabic', 'cp1257' => 'Windows Baltic', 'binary' => 'Binary pseudo charset', 'geostd8' => 'GEOSTD8 Georgian', 'cp932' => 'SJIS for Windows Japanese', 'eucjpms' => 'UJIS for Windows Japanese', ); } /** * Fetch a database collation for a particular database character set * * @param string $charset The database character set * @return string|bool The matching database collation, false if unsupported */ function fetch_charset_collation($charset) { $collations = array( 'big5' => 'big5_chinese_ci', 'dec8' => 'dec8_swedish_ci', 'cp850' => 'cp850_general_ci', 'hp8' => 'hp8_english_ci', 'koi8r' => 'koi8r_general_ci', 'latin1' => 'latin1_swedish_ci', 'latin2' => 'latin2_general_ci', 'swe7' => 'swe7_swedish_ci', 'ascii' => 'ascii_general_ci', 'ujis' => 'ujis_japanese_ci', 'sjis' => 'sjis_japanese_ci', 'hebrew' => 'hebrew_general_ci', 'tis620' => 'tis620_thai_ci', 'euckr' => 'euckr_korean_ci', 'koi8u' => 'koi8u_general_ci', 'gb2312' => 'gb2312_chinese_ci', 'greek' => 'greek_general_ci', 'cp1250' => 'cp1250_general_ci', 'gbk' => 'gbk_chinese_ci', 'latin5' => 'latin5_turkish_ci', 'armscii8' => 'armscii8_general_ci', 'utf8' => 'utf8_general_ci', 'utf8mb4' => 'utf8mb4_general_ci', 'ucs2' => 'ucs2_general_ci', 'cp866' => 'cp866_general_ci', 'keybcs2' => 'keybcs2_general_ci', 'macce' => 'macce_general_ci', 'macroman' => 'macroman_general_ci', 'cp852' => 'cp852_general_ci', 'latin7' => 'latin7_general_ci', 'cp1251' => 'cp1251_general_ci', 'cp1256' => 'cp1256_general_ci', 'cp1257' => 'cp1257_general_ci', 'binary' => 'binary', 'geostd8' => 'geostd8_general_ci', 'cp932' => 'cp932_japanese_ci', 'eucjpms' => 'eucjpms_japanese_ci', ); if($collations[$charset]) { return $collations[$charset]; } return false; } /** * Fetch a character set/collation string for use with CREATE TABLE statements. Uses current DB encoding * * @return string The built string, empty if unsupported */ function build_create_table_collation() { if(!$this->db_encoding) { return ''; } $collation = $this->fetch_charset_collation($this->db_encoding); if(!$collation) { return ''; } return " CHARACTER SET {$this->db_encoding} COLLATE {$collation}"; } /** * Time how long it takes for a particular piece of code to run. Place calls above & below the block of code. * * @deprecated */ function get_execution_time() { return get_execution_time(); } /** * Binary database fields require special attention. * * @param string $string Binary value * @return string Encoded binary value */ function escape_binary($string) { return "X'".$this->escape_string(bin2hex($string))."'"; } /** * Unescape binary data. * * @param string $string Binary value * @return string Encoded binary value */ function unescape_binary($string) { // Nothing to do return $string; } }