| | |
| | | protected $db_mode; // Connection mode |
| | | protected $dbh; // Connection handle |
| | | protected $dbhs = array(); |
| | | protected $table_connections = array(); |
| | | |
| | | protected $db_error = false; |
| | | protected $db_error_msg = ''; |
| | |
| | | ); |
| | | |
| | | const DEBUG_LINE_LENGTH = 4096; |
| | | const DEFAULT_QUOTE = '`'; |
| | | |
| | | /** |
| | | * Factory, returns driver-specific instance of the class |
| | |
| | | 'sybase' => 'mssql', |
| | | 'dblib' => 'mssql', |
| | | 'mysqli' => 'mysql', |
| | | 'oci' => 'oracle', |
| | | 'oci8' => 'oracle', |
| | | ); |
| | | |
| | | $driver = isset($driver_map[$driver]) ? $driver_map[$driver] : $driver; |
| | |
| | | $this->db_dsnw = $db_dsnw; |
| | | $this->db_dsnr = $db_dsnr; |
| | | $this->db_pconn = $pconn; |
| | | $this->db_dsnw_noread = rcube::get_instance()->config->get('db_dsnw_noread', false); |
| | | |
| | | $this->db_dsnw_array = self::parse_dsn($db_dsnw); |
| | | $this->db_dsnr_array = self::parse_dsn($db_dsnr); |
| | | |
| | | $config = rcube::get_instance()->config; |
| | | |
| | | $this->options['table_prefix'] = $config->get('db_prefix'); |
| | | $this->options['dsnw_noread'] = $config->get('db_dsnw_noread', false); |
| | | $this->options['table_dsn_map'] = array_map(array($this, 'table_name'), $config->get('db_table_dsn', array())); |
| | | } |
| | | |
| | | /** |
| | |
| | | return $this->dbh; |
| | | } |
| | | |
| | | // connect to database |
| | | if ($dbh = $this->conn_create($dsn)) { |
| | | $this->dbh = $dbh; |
| | | $this->dbhs[$mode] = $dbh; |
| | | $this->db_mode = $mode; |
| | | $this->db_connected = true; |
| | | } |
| | | } |
| | | |
| | | /** |
| | | * Create PDO connection |
| | | */ |
| | | protected function conn_create($dsn) |
| | | { |
| | | // Get database specific connection options |
| | | $dsn_string = $this->dsn_string($dsn); |
| | | $dsn_options = $this->dsn_options($dsn); |
| | |
| | | |
| | | // don't throw exceptions or warnings |
| | | $dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT); |
| | | |
| | | $this->conn_configure($dsn, $dbh); |
| | | } |
| | | catch (Exception $e) { |
| | | $this->db_error = true; |
| | |
| | | return null; |
| | | } |
| | | |
| | | $this->dbh = $dbh; |
| | | $this->dbhs[$mode] = $dbh; |
| | | $this->db_mode = $mode; |
| | | $this->db_connected = true; |
| | | $this->conn_configure($dsn, $dbh); |
| | | return $dbh; |
| | | } |
| | | |
| | | /** |
| | |
| | | * Connect to appropriate database depending on the operation |
| | | * |
| | | * @param string $mode Connection mode (r|w) |
| | | * @param boolean $force Enforce using the given mode |
| | | */ |
| | | public function db_connect($mode) |
| | | public function db_connect($mode, $force = false) |
| | | { |
| | | // previous connection failed, don't attempt to connect again |
| | | if ($this->conn_failure) { |
| | |
| | | // Already connected |
| | | if ($this->db_connected) { |
| | | // connected to db with the same or "higher" mode (if allowed) |
| | | if ($this->db_mode == $mode || $this->db_mode == 'w' && !$this->db_dsnw_noread) { |
| | | if ($this->db_mode == $mode || $this->db_mode == 'w' && !$force && !$this->options['dsnw_noread']) { |
| | | return; |
| | | } |
| | | } |
| | |
| | | } |
| | | |
| | | $this->conn_failure = !$this->db_connected; |
| | | } |
| | | |
| | | /** |
| | | * Analyze the given SQL statement and select the appropriate connection to use |
| | | */ |
| | | protected function dsn_select($query) |
| | | { |
| | | // no replication |
| | | if ($this->db_dsnw == $this->db_dsnr) { |
| | | return 'w'; |
| | | } |
| | | |
| | | // Read or write ? |
| | | $mode = preg_match('/^(select|show|set)/i', $query) ? 'r' : 'w'; |
| | | |
| | | $start = '[' . $this->options['identifier_start'] . self::DEFAULT_QUOTE . ']'; |
| | | $end = '[' . $this->options['identifier_end'] . self::DEFAULT_QUOTE . ']'; |
| | | $regex = '/(?:^|\s)(from|update|into|join)\s+'.$start.'?([a-z0-9._]+)'.$end.'?\s+/i'; |
| | | |
| | | // find tables involved in this query |
| | | if (preg_match_all($regex, $query, $matches, PREG_SET_ORDER)) { |
| | | foreach ($matches as $m) { |
| | | $table = $m[2]; |
| | | |
| | | // always use direct mapping |
| | | if ($this->options['table_dsn_map'][$table]) { |
| | | $mode = $this->options['table_dsn_map'][$table]; |
| | | break; // primary table rules |
| | | } |
| | | else if ($mode == 'r') { |
| | | // connected to db with the same or "higher" mode for this table |
| | | $db_mode = $this->table_connections[$table]; |
| | | if ($db_mode == 'w' && !$this->options['dsnw_noread']) { |
| | | $mode = $db_mode; |
| | | } |
| | | } |
| | | } |
| | | |
| | | // remember mode chosen (for primary table) |
| | | $table = $matches[0][2]; |
| | | $this->table_connections[$table] = $mode; |
| | | } |
| | | |
| | | return $mode; |
| | | } |
| | | |
| | | /** |
| | |
| | | */ |
| | | protected function _query($query, $offset, $numrows, $params) |
| | | { |
| | | $query = trim($query); |
| | | $query = ltrim($query); |
| | | |
| | | // Read or write ? |
| | | $mode = preg_match('/^(select|show|set)/i', $query) ? 'r' : 'w'; |
| | | |
| | | $this->db_connect($mode); |
| | | $this->db_connect($this->dsn_select($query), true); |
| | | |
| | | // check connection before proceeding |
| | | if (!$this->is_connected()) { |
| | |
| | | $query = $this->set_limit($query, $numrows, $offset); |
| | | } |
| | | |
| | | $params = (array) $params; |
| | | // replace self::DEFAULT_QUOTE with driver-specific quoting |
| | | $query = $this->query_parse($query); |
| | | |
| | | // Because in Roundcube we mostly use queries that are |
| | | // executed only once, we will not use prepared queries |
| | | $pos = 0; |
| | | $idx = 0; |
| | | |
| | | while ($pos = strpos($query, '?', $pos)) { |
| | | if ($query[$pos+1] == '?') { // skip escaped ? |
| | | $pos += 2; |
| | | } |
| | | else { |
| | | $val = $this->quote($params[$idx++]); |
| | | unset($params[$idx-1]); |
| | | $query = substr_replace($query, $val, $pos, 1); |
| | | $pos += strlen($val); |
| | | if (count($params)) { |
| | | while ($pos = strpos($query, '?', $pos)) { |
| | | if ($query[$pos+1] == '?') { // skip escaped '?' |
| | | $pos += 2; |
| | | } |
| | | else { |
| | | $val = $this->quote($params[$idx++]); |
| | | unset($params[$idx-1]); |
| | | $query = substr_replace($query, $val, $pos, 1); |
| | | $pos += strlen($val); |
| | | } |
| | | } |
| | | } |
| | | |
| | | // replace escaped ? back to normal |
| | | $query = rtrim(strtr($query, array('??' => '?')), ';'); |
| | | // replace escaped '?' back to normal, see self::quote() |
| | | $query = str_replace('??', '?', $query); |
| | | $query = rtrim($query, " \t\n\r\0\x0B;"); |
| | | |
| | | // log query |
| | | $this->debug($query); |
| | | |
| | | return $this->query_execute($query); |
| | | } |
| | | |
| | | /** |
| | | * Query execution |
| | | */ |
| | | protected function query_execute($query) |
| | | { |
| | | // destroy reference to previous result, required for SQLite driver (#1488874) |
| | | $this->last_result = null; |
| | | $this->last_result = null; |
| | | $this->db_error_msg = null; |
| | | |
| | | // send query |
| | |
| | | $result = $this->handle_error($query); |
| | | } |
| | | |
| | | $this->last_result = $result; |
| | | return $this->last_result = $result; |
| | | } |
| | | |
| | | return $result; |
| | | /** |
| | | * Parse SQL query and replace identifier quoting |
| | | * |
| | | * @param string $query SQL query |
| | | * |
| | | * @return string SQL query |
| | | */ |
| | | protected function query_parse($query) |
| | | { |
| | | $start = $this->options['identifier_start']; |
| | | $end = $this->options['identifier_end']; |
| | | $quote = self::DEFAULT_QUOTE; |
| | | |
| | | if ($start == $quote) { |
| | | return $query; |
| | | } |
| | | |
| | | $pos = 0; |
| | | $in = false; |
| | | |
| | | while ($pos = strpos($query, $quote, $pos)) { |
| | | if ($query[$pos+1] == $quote) { // skip escaped quote |
| | | $pos += 2; |
| | | } |
| | | else { |
| | | if ($in) { |
| | | $q = $end; |
| | | $in = false; |
| | | } |
| | | else { |
| | | $q = $start; |
| | | $in = true; |
| | | } |
| | | |
| | | $query = substr_replace($query, $q, $pos, 1); |
| | | $pos++; |
| | | } |
| | | } |
| | | |
| | | // replace escaped quote back to normal, see self::quote() |
| | | $query = str_replace($quote.$quote, $quote, $query); |
| | | |
| | | return $query; |
| | | } |
| | | |
| | | /** |
| | |
| | | { |
| | | $error = $this->dbh->errorInfo(); |
| | | |
| | | if (empty($this->options['ignore_key_errors']) || $error[0] != '23000') { |
| | | if (empty($this->options['ignore_key_errors']) || !in_array($error[0], array('23000', '23505'))) { |
| | | $this->db_error = true; |
| | | $this->db_error_msg = sprintf('[%s] %s', $error[1], $error[2]); |
| | | |
| | |
| | | public function affected_rows($result = null) |
| | | { |
| | | if ($result || ($result === null && ($result = $this->last_result))) { |
| | | return $result->rowCount(); |
| | | if ($result !== true) { |
| | | return $result->rowCount(); |
| | | } |
| | | } |
| | | |
| | | return 0; |
| | |
| | | */ |
| | | public function num_rows($result = null) |
| | | { |
| | | if ($result || ($result === null && ($result = $this->last_result))) { |
| | | if (($result || ($result === null && ($result = $this->last_result))) && $result !== true) { |
| | | // repeat query with SELECT COUNT(*) ... |
| | | if (preg_match('/^SELECT\s+(?:ALL\s+|DISTINCT\s+)?(?:.*?)\s+FROM\s+(.*)$/ims', $result->queryString, $m)) { |
| | | $query = $this->dbh->query('SELECT COUNT(*) FROM ' . $m[1], PDO::FETCH_NUM); |
| | |
| | | protected function _fetch_row($result, $mode) |
| | | { |
| | | if ($result || ($result === null && ($result = $this->last_result))) { |
| | | return $result->fetch($mode); |
| | | if ($result !== true) { |
| | | return $result->fetch($mode); |
| | | } |
| | | } |
| | | |
| | | return false; |
| | |
| | | } |
| | | |
| | | /** |
| | | * Start transaction |
| | | * |
| | | * @return bool True on success, False on failure |
| | | */ |
| | | public function startTransaction() |
| | | { |
| | | $this->db_connect('w', true); |
| | | |
| | | // check connection before proceeding |
| | | if (!$this->is_connected()) { |
| | | return $this->last_result = false; |
| | | } |
| | | |
| | | $this->debug('BEGIN TRANSACTION'); |
| | | |
| | | return $this->last_result = $this->dbh->beginTransaction(); |
| | | } |
| | | |
| | | /** |
| | | * Commit transaction |
| | | * |
| | | * @return bool True on success, False on failure |
| | | */ |
| | | public function endTransaction() |
| | | { |
| | | $this->db_connect('w', true); |
| | | |
| | | // check connection before proceeding |
| | | if (!$this->is_connected()) { |
| | | return $this->last_result = false; |
| | | } |
| | | |
| | | $this->debug('COMMIT TRANSACTION'); |
| | | |
| | | return $this->last_result = $this->dbh->commit(); |
| | | } |
| | | |
| | | /** |
| | | * Rollback transaction |
| | | * |
| | | * @return bool True on success, False on failure |
| | | */ |
| | | public function rollbackTransaction() |
| | | { |
| | | $this->db_connect('w', true); |
| | | |
| | | // check connection before proceeding |
| | | if (!$this->is_connected()) { |
| | | return $this->last_result = false; |
| | | } |
| | | |
| | | $this->debug('ROLLBACK TRANSACTION'); |
| | | |
| | | return $this->last_result = $this->dbh->rollBack(); |
| | | } |
| | | |
| | | /** |
| | | * Formats input so it can be safely used in a query |
| | | * |
| | | * @param mixed $input Value to quote |
| | |
| | | 'bool' => PDO::PARAM_BOOL, |
| | | 'integer' => PDO::PARAM_INT, |
| | | ); |
| | | |
| | | $type = isset($map[$type]) ? $map[$type] : PDO::PARAM_STR; |
| | | return strtr($this->dbh->quote($input, $type), array('?' => '??')); // escape ? |
| | | |
| | | return strtr($this->dbh->quote($input, $type), |
| | | // escape ? and ` |
| | | array('?' => '??', self::DEFAULT_QUOTE => self::DEFAULT_QUOTE.self::DEFAULT_QUOTE) |
| | | ); |
| | | } |
| | | |
| | | return 'NULL'; |
| | |
| | | /** |
| | | * Return correct name for a specific database table |
| | | * |
| | | * @param string $table Table name |
| | | * @param string $table Table name |
| | | * @param bool $quoted Quote table identifier |
| | | * |
| | | * @return string Translated table name |
| | | */ |
| | | public function table_name($table) |
| | | public function table_name($table, $quoted = false) |
| | | { |
| | | $rcube = rcube::get_instance(); |
| | | // let plugins alter the table name (#1489837) |
| | | $plugin = rcube::get_instance()->plugins->exec_hook('db_table_name', array('table' => $table)); |
| | | $table = $plugin['table']; |
| | | |
| | | // add prefix to the table name if configured |
| | | if ($prefix = $rcube->config->get('db_prefix')) { |
| | | return $prefix . $table; |
| | | if (($prefix = $this->options['table_prefix']) && strpos($table, $prefix) !== 0) { |
| | | $table = $prefix . $table; |
| | | } |
| | | |
| | | if ($quoted) { |
| | | $table = $this->quote_identifier($table); |
| | | } |
| | | |
| | | return $table; |
| | |
| | | public function set_option($name, $value) |
| | | { |
| | | $this->options[$name] = $value; |
| | | } |
| | | |
| | | /** |
| | | * Set DSN connection to be used for the given table |
| | | * |
| | | * @param string Table name |
| | | * @param string DSN connection ('r' or 'w') to be used |
| | | */ |
| | | public function set_table_dsn($table, $mode) |
| | | { |
| | | $this->options['table_dsn_map'][$this->table_name($table)] = $mode; |
| | | } |
| | | |
| | | /** |
| | |
| | | |
| | | return $result; |
| | | } |
| | | |
| | | /** |
| | | * Execute the given SQL script |
| | | * |
| | | * @param string SQL queries to execute |
| | | * |
| | | * @return boolen True on success, False on error |
| | | */ |
| | | public function exec_script($sql) |
| | | { |
| | | $sql = $this->fix_table_names($sql); |
| | | $buff = ''; |
| | | |
| | | foreach (explode("\n", $sql) as $line) { |
| | | if (preg_match('/^--/', $line) || trim($line) == '') |
| | | continue; |
| | | |
| | | $buff .= $line . "\n"; |
| | | if (preg_match('/(;|^GO)$/', trim($line))) { |
| | | $this->query($buff); |
| | | $buff = ''; |
| | | if ($this->db_error) { |
| | | break; |
| | | } |
| | | } |
| | | } |
| | | |
| | | return !$this->db_error; |
| | | } |
| | | |
| | | /** |
| | | * Parse SQL file and fix table names according to table prefix |
| | | */ |
| | | protected function fix_table_names($sql) |
| | | { |
| | | if (!$this->options['table_prefix']) { |
| | | return $sql; |
| | | } |
| | | |
| | | $sql = preg_replace_callback( |
| | | '/((TABLE|TRUNCATE|(?<!ON )UPDATE|INSERT INTO|FROM' |
| | | . '| ON(?! (DELETE|UPDATE))|REFERENCES|CONSTRAINT|FOREIGN KEY|INDEX)' |
| | | . '\s+(IF (NOT )?EXISTS )?[`"]*)([^`"\( \r\n]+)/', |
| | | array($this, 'fix_table_names_callback'), |
| | | $sql |
| | | ); |
| | | |
| | | return $sql; |
| | | } |
| | | |
| | | /** |
| | | * Preg_replace callback for fix_table_names() |
| | | */ |
| | | protected function fix_table_names_callback($matches) |
| | | { |
| | | return $matches[1] . $this->options['table_prefix'] . $matches[count($matches)-1]; |
| | | } |
| | | } |