blob: bd575928972cc6d4dbb0709566539559618eb071 [file] [log] [blame]
Andrey Andreevb76029d2012-01-26 15:13:19 +02001<?php if ( ! defined('BASEPATH')) exit('No direct script access allowed');
Derek Allard2067d1a2008-11-13 22:59:24 +00002/**
3 * CodeIgniter
4 *
Phil Sturgeon07c1ac82012-03-09 17:03:37 +00005 * An open source application development framework for PHP 5.2.4 or newer
Derek Allard2067d1a2008-11-13 22:59:24 +00006 *
Derek Jonesf4a4bd82011-10-20 12:18:42 -05007 * NOTICE OF LICENSE
Andrey Andreevb76029d2012-01-26 15:13:19 +02008 *
Derek Jonesf4a4bd82011-10-20 12:18:42 -05009 * Licensed under the Open Software License version 3.0
Andrey Andreevb76029d2012-01-26 15:13:19 +020010 *
Derek Jonesf4a4bd82011-10-20 12:18:42 -050011 * This source file is subject to the Open Software License (OSL 3.0) that is
12 * bundled with this package in the files license.txt / license.rst. It is
13 * also available through the world wide web at this URL:
14 * http://opensource.org/licenses/OSL-3.0
15 * If you did not receive a copy of the license and are unable to obtain it
16 * through the world wide web, please send an email to
17 * licensing@ellislab.com so we can send you a copy immediately.
18 *
Derek Allard2067d1a2008-11-13 22:59:24 +000019 * @package CodeIgniter
Derek Jonesf4a4bd82011-10-20 12:18:42 -050020 * @author EllisLab Dev Team
Greg Aker0defe5d2012-01-01 18:46:41 -060021 * @copyright Copyright (c) 2008 - 2012, EllisLab, Inc. (http://ellislab.com/)
Derek Jonesf4a4bd82011-10-20 12:18:42 -050022 * @license http://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0)
Derek Allard2067d1a2008-11-13 22:59:24 +000023 * @link http://codeigniter.com
24 * @since Version 1.0
25 * @filesource
26 */
27
Derek Allard2067d1a2008-11-13 22:59:24 +000028/**
29 * ODBC Database Adapter Class
30 *
31 * Note: _DB is an extender class that the app controller
Jamie Rumbelow7efad202012-02-19 12:37:00 +000032 * creates dynamically based on whether the query builder
Derek Allard2067d1a2008-11-13 22:59:24 +000033 * class is being used or not.
34 *
35 * @package CodeIgniter
36 * @subpackage Drivers
37 * @category Database
Derek Jonesf4a4bd82011-10-20 12:18:42 -050038 * @author EllisLab Dev Team
Derek Allard2067d1a2008-11-13 22:59:24 +000039 * @link http://codeigniter.com/user_guide/database/
40 */
41class CI_DB_odbc_driver extends CI_DB {
42
Andrey Andreevb76029d2012-01-26 15:13:19 +020043 public $dbdriver = 'odbc';
Barry Mienydd671972010-10-04 16:33:58 +020044
Derek Allard2067d1a2008-11-13 22:59:24 +000045 // the character used to excape - not necessary for ODBC
Andrey Andreevb76029d2012-01-26 15:13:19 +020046 protected $_escape_char = '';
Barry Mienydd671972010-10-04 16:33:58 +020047
Derek Jonese4ed5832009-02-20 21:44:59 +000048 // clause and character used for LIKE escape sequences
Andrey Andreev5f356bf2012-03-20 14:32:27 +020049 protected $_like_escape_str = " {escape '%s'} ";
Andrey Andreevb76029d2012-01-26 15:13:19 +020050 protected $_like_escape_chr = '!';
Barry Mienydd671972010-10-04 16:33:58 +020051
Derek Allard2067d1a2008-11-13 22:59:24 +000052 /**
53 * The syntax to count rows is slightly different across different
54 * database engines, so this string appears in each driver and is
55 * used for the count_all() and count_all_results() functions.
56 */
Andrey Andreevb76029d2012-01-26 15:13:19 +020057 protected $_count_string = 'SELECT COUNT(*) AS ';
58 protected $_random_keyword;
Derek Allard2067d1a2008-11-13 22:59:24 +000059
Andrey Andreev5f356bf2012-03-20 14:32:27 +020060 public function __construct($params)
Derek Allard2067d1a2008-11-13 22:59:24 +000061 {
Timothy Warrena2097a02011-10-10 10:10:46 -040062 parent::__construct($params);
Barry Mienydd671972010-10-04 16:33:58 +020063
Derek Allard2067d1a2008-11-13 22:59:24 +000064 $this->_random_keyword = ' RND('.time().')'; // database specific random keyword
Andrey Andreev46f6dbc2012-02-13 01:39:53 +020065
66 // Legacy support for DSN in the hostname field
Andrey Andreeve4c30192012-06-04 15:08:24 +030067 if (empty($this->dsn))
Andrey Andreev46f6dbc2012-02-13 01:39:53 +020068 {
69 $this->dsn = $this->hostname;
70 }
Derek Allard2067d1a2008-11-13 22:59:24 +000071 }
72
73 /**
74 * Non-persistent database connection
75 *
Derek Allard2067d1a2008-11-13 22:59:24 +000076 * @return resource
Barry Mienydd671972010-10-04 16:33:58 +020077 */
Andrey Andreevb76029d2012-01-26 15:13:19 +020078 public function db_connect()
Derek Allard2067d1a2008-11-13 22:59:24 +000079 {
Andrey Andreev46f6dbc2012-02-13 01:39:53 +020080 return @odbc_connect($this->dsn, $this->username, $this->password);
Derek Allard2067d1a2008-11-13 22:59:24 +000081 }
Barry Mienydd671972010-10-04 16:33:58 +020082
Derek Allard2067d1a2008-11-13 22:59:24 +000083 // --------------------------------------------------------------------
84
85 /**
86 * Persistent database connection
87 *
Derek Allard2067d1a2008-11-13 22:59:24 +000088 * @return resource
Barry Mienydd671972010-10-04 16:33:58 +020089 */
Andrey Andreevb76029d2012-01-26 15:13:19 +020090 public function db_pconnect()
Derek Allard2067d1a2008-11-13 22:59:24 +000091 {
Andrey Andreev46f6dbc2012-02-13 01:39:53 +020092 return @odbc_pconnect($this->dsn, $this->username, $this->password);
Derek Allard2067d1a2008-11-13 22:59:24 +000093 }
Barry Mienydd671972010-10-04 16:33:58 +020094
Derek Allard2067d1a2008-11-13 22:59:24 +000095 // --------------------------------------------------------------------
96
97 /**
Derek Allard2067d1a2008-11-13 22:59:24 +000098 * Execute the query
99 *
Derek Allard2067d1a2008-11-13 22:59:24 +0000100 * @param string an SQL query
101 * @return resource
Barry Mienydd671972010-10-04 16:33:58 +0200102 */
Andrey Andreevb76029d2012-01-26 15:13:19 +0200103 protected function _execute($sql)
Derek Allard2067d1a2008-11-13 22:59:24 +0000104 {
Derek Allard2067d1a2008-11-13 22:59:24 +0000105 return @odbc_exec($this->conn_id, $sql);
Derek Allard2067d1a2008-11-13 22:59:24 +0000106 }
107
108 // --------------------------------------------------------------------
109
110 /**
111 * Begin Transaction
112 *
Barry Mienydd671972010-10-04 16:33:58 +0200113 * @return bool
114 */
Andrey Andreevb76029d2012-01-26 15:13:19 +0200115 public function trans_begin($test_mode = FALSE)
Derek Allard2067d1a2008-11-13 22:59:24 +0000116 {
Derek Allard2067d1a2008-11-13 22:59:24 +0000117 // When transactions are nested we only begin/commit/rollback the outermost ones
Andrey Andreevb76029d2012-01-26 15:13:19 +0200118 if ( ! $this->trans_enabled OR $this->_trans_depth > 0)
Derek Allard2067d1a2008-11-13 22:59:24 +0000119 {
120 return TRUE;
121 }
122
123 // Reset the transaction failure flag.
124 // If the $test_mode flag is set to TRUE transactions will be rolled back
125 // even if the queries produce a successful result.
Andrey Andreevb76029d2012-01-26 15:13:19 +0200126 $this->_trans_failure = ($test_mode === TRUE);
Derek Allard2067d1a2008-11-13 22:59:24 +0000127
128 return odbc_autocommit($this->conn_id, FALSE);
129 }
130
131 // --------------------------------------------------------------------
132
133 /**
134 * Commit Transaction
135 *
Barry Mienydd671972010-10-04 16:33:58 +0200136 * @return bool
137 */
Andrey Andreevb76029d2012-01-26 15:13:19 +0200138 public function trans_commit()
Derek Allard2067d1a2008-11-13 22:59:24 +0000139 {
Derek Allard2067d1a2008-11-13 22:59:24 +0000140 // When transactions are nested we only begin/commit/rollback the outermost ones
Andrey Andreevb76029d2012-01-26 15:13:19 +0200141 if ( ! $this->trans_enabled OR $this->_trans_depth > 0)
Derek Allard2067d1a2008-11-13 22:59:24 +0000142 {
143 return TRUE;
144 }
145
146 $ret = odbc_commit($this->conn_id);
147 odbc_autocommit($this->conn_id, TRUE);
148 return $ret;
149 }
150
151 // --------------------------------------------------------------------
152
153 /**
154 * Rollback Transaction
155 *
Barry Mienydd671972010-10-04 16:33:58 +0200156 * @return bool
157 */
Andrey Andreevb76029d2012-01-26 15:13:19 +0200158 public function trans_rollback()
Derek Allard2067d1a2008-11-13 22:59:24 +0000159 {
Derek Allard2067d1a2008-11-13 22:59:24 +0000160 // When transactions are nested we only begin/commit/rollback the outermost ones
Andrey Andreevb76029d2012-01-26 15:13:19 +0200161 if ( ! $this->trans_enabled OR $this->_trans_depth > 0)
Derek Allard2067d1a2008-11-13 22:59:24 +0000162 {
163 return TRUE;
164 }
165
166 $ret = odbc_rollback($this->conn_id);
167 odbc_autocommit($this->conn_id, TRUE);
168 return $ret;
169 }
170
171 // --------------------------------------------------------------------
172
173 /**
174 * Escape String
175 *
Derek Allard2067d1a2008-11-13 22:59:24 +0000176 * @param string
Derek Jonese4ed5832009-02-20 21:44:59 +0000177 * @param bool whether or not the string will be used in a LIKE condition
Derek Allard2067d1a2008-11-13 22:59:24 +0000178 * @return string
179 */
Andrey Andreevb76029d2012-01-26 15:13:19 +0200180 public function escape_str($str, $like = FALSE)
Derek Allard2067d1a2008-11-13 22:59:24 +0000181 {
Derek Jonese4ed5832009-02-20 21:44:59 +0000182 if (is_array($str))
183 {
Pascal Krietec3a4a8d2011-02-14 13:40:08 -0500184 foreach ($str as $key => $val)
Barry Mienydd671972010-10-04 16:33:58 +0200185 {
Derek Jonese4ed5832009-02-20 21:44:59 +0000186 $str[$key] = $this->escape_str($val, $like);
Barry Mienydd671972010-10-04 16:33:58 +0200187 }
188
189 return $str;
190 }
191
Greg Aker757dda62010-04-14 19:06:19 -0500192 $str = remove_invisible_characters($str);
Barry Mienydd671972010-10-04 16:33:58 +0200193
Derek Jonese4ed5832009-02-20 21:44:59 +0000194 // escape LIKE condition wildcards
195 if ($like === TRUE)
196 {
Andrey Andreev5e18e892012-03-09 14:25:00 +0200197 return str_replace(array($this->_like_escape_chr, '%', '_'),
198 array($this->_like_escape_chr.$this->_like_escape_chr, $this->_like_escape_chr.'%', $this->_like_escape_chr.'_'),
Andrey Andreevb76029d2012-01-26 15:13:19 +0200199 $str);
Derek Jonese4ed5832009-02-20 21:44:59 +0000200 }
Barry Mienydd671972010-10-04 16:33:58 +0200201
Derek Jonese4ed5832009-02-20 21:44:59 +0000202 return $str;
Derek Allard2067d1a2008-11-13 22:59:24 +0000203 }
Barry Mienydd671972010-10-04 16:33:58 +0200204
Derek Allard2067d1a2008-11-13 22:59:24 +0000205 // --------------------------------------------------------------------
206
207 /**
208 * Affected Rows
209 *
Andrey Andreevb76029d2012-01-26 15:13:19 +0200210 * @return int
Derek Allard2067d1a2008-11-13 22:59:24 +0000211 */
Andrey Andreevb76029d2012-01-26 15:13:19 +0200212 public function affected_rows()
Derek Allard2067d1a2008-11-13 22:59:24 +0000213 {
214 return @odbc_num_rows($this->conn_id);
215 }
Barry Mienydd671972010-10-04 16:33:58 +0200216
Derek Allard2067d1a2008-11-13 22:59:24 +0000217 // --------------------------------------------------------------------
218
219 /**
220 * Insert ID
221 *
Andrey Andreev8af76662012-03-05 14:33:41 +0200222 * @return bool
Derek Allard2067d1a2008-11-13 22:59:24 +0000223 */
Andrey Andreevb76029d2012-01-26 15:13:19 +0200224 public function insert_id()
Derek Allard2067d1a2008-11-13 22:59:24 +0000225 {
Andrey Andreev8af76662012-03-05 14:33:41 +0200226 return ($this->db->db_debug) ? $this->db->display_error('db_unsuported_feature') : FALSE;
Derek Allard2067d1a2008-11-13 22:59:24 +0000227 }
228
229 // --------------------------------------------------------------------
230
231 /**
Derek Allard2067d1a2008-11-13 22:59:24 +0000232 * Show table query
233 *
234 * Generates a platform-specific query string so that the table names can be fetched
235 *
Andrey Andreev5f356bf2012-03-20 14:32:27 +0200236 * @param bool
Derek Allard2067d1a2008-11-13 22:59:24 +0000237 * @return string
238 */
Andrey Andreevb76029d2012-01-26 15:13:19 +0200239 protected function _list_tables($prefix_limit = FALSE)
Derek Allard2067d1a2008-11-13 22:59:24 +0000240 {
Andrey Andreeve4c30192012-06-04 15:08:24 +0300241 $sql = 'SHOW TABLES FROM '.$this->database;
Derek Allard2067d1a2008-11-13 22:59:24 +0000242
Andrey Andreeve4c30192012-06-04 15:08:24 +0300243 if ($prefix_limit !== FALSE && $this->dbprefix !== '')
Derek Allard2067d1a2008-11-13 22:59:24 +0000244 {
Greg Aker0d424892010-01-26 02:14:44 +0000245 //$sql .= " LIKE '".$this->escape_like_str($this->dbprefix)."%' ".sprintf($this->_like_escape_str, $this->_like_escape_chr);
Derek Allard2067d1a2008-11-13 22:59:24 +0000246 return FALSE; // not currently supported
247 }
Barry Mienydd671972010-10-04 16:33:58 +0200248
Derek Allard2067d1a2008-11-13 22:59:24 +0000249 return $sql;
250 }
Barry Mienydd671972010-10-04 16:33:58 +0200251
Derek Allard2067d1a2008-11-13 22:59:24 +0000252 // --------------------------------------------------------------------
253
254 /**
255 * Show column query
256 *
257 * Generates a platform-specific query string so that the column names can be fetched
258 *
Derek Allard2067d1a2008-11-13 22:59:24 +0000259 * @param string the table name
260 * @return string
261 */
Andrey Andreevb76029d2012-01-26 15:13:19 +0200262 protected function _list_columns($table = '')
Derek Allard2067d1a2008-11-13 22:59:24 +0000263 {
Andrey Andreevb76029d2012-01-26 15:13:19 +0200264 return 'SHOW COLUMNS FROM '.$table;
Derek Allard2067d1a2008-11-13 22:59:24 +0000265 }
266
267 // --------------------------------------------------------------------
268
269 /**
270 * Field data query
271 *
272 * Generates a platform-specific query so that the column data can be retrieved
273 *
Derek Allard2067d1a2008-11-13 22:59:24 +0000274 * @param string the table name
Andrey Andreevb76029d2012-01-26 15:13:19 +0200275 * @return string
Derek Allard2067d1a2008-11-13 22:59:24 +0000276 */
Andrey Andreevb76029d2012-01-26 15:13:19 +0200277 protected function _field_data($table)
Derek Allard2067d1a2008-11-13 22:59:24 +0000278 {
Andrey Andreevb76029d2012-01-26 15:13:19 +0200279 return 'SELECT TOP 1 FROM '.$table;
Derek Allard2067d1a2008-11-13 22:59:24 +0000280 }
281
282 // --------------------------------------------------------------------
283
284 /**
Andrey Andreev4be5de12012-03-02 15:45:41 +0200285 * Error
Derek Allard2067d1a2008-11-13 22:59:24 +0000286 *
Andrey Andreev4be5de12012-03-02 15:45:41 +0200287 * Returns an array containing code and message of the last
288 * database error that has occured.
Derek Allard2067d1a2008-11-13 22:59:24 +0000289 *
Andrey Andreev4be5de12012-03-02 15:45:41 +0200290 * @return array
Derek Allard2067d1a2008-11-13 22:59:24 +0000291 */
Andrey Andreev4be5de12012-03-02 15:45:41 +0200292 public function error()
Derek Allard2067d1a2008-11-13 22:59:24 +0000293 {
Andrey Andreev4be5de12012-03-02 15:45:41 +0200294 return array('code' => odbc_error($this->conn_id), 'message' => odbc_errormsg($this->conn_id));
Derek Allard2067d1a2008-11-13 22:59:24 +0000295 }
296
297 // --------------------------------------------------------------------
298
299 /**
Derek Allard2067d1a2008-11-13 22:59:24 +0000300 * From Tables
301 *
302 * This function implicitly groups FROM tables so there is no confusion
303 * about operator precedence in harmony with SQL standards
304 *
Andrey Andreev5f356bf2012-03-20 14:32:27 +0200305 * @param array
Andrey Andreevb76029d2012-01-26 15:13:19 +0200306 * @return string
Derek Allard2067d1a2008-11-13 22:59:24 +0000307 */
Andrey Andreevb76029d2012-01-26 15:13:19 +0200308 protected function _from_tables($tables)
Derek Allard2067d1a2008-11-13 22:59:24 +0000309 {
Andrey Andreevc78e56a2012-06-08 02:12:07 +0300310 return is_array($tables) ? implode(', ', $tables) : $tables;
Derek Allard2067d1a2008-11-13 22:59:24 +0000311 }
312
313 // --------------------------------------------------------------------
Barry Mienydd671972010-10-04 16:33:58 +0200314
Derek Allard2067d1a2008-11-13 22:59:24 +0000315 /**
Derek Allard2067d1a2008-11-13 22:59:24 +0000316 * Truncate statement
317 *
318 * Generates a platform-specific truncate string from the supplied data
Andrey Andreeva6fe36e2012-04-05 16:00:32 +0300319 *
320 * If the database does not support the truncate() command,
321 * then this method maps to 'DELETE FROM table'
Derek Allard2067d1a2008-11-13 22:59:24 +0000322 *
Derek Allard2067d1a2008-11-13 22:59:24 +0000323 * @param string the table name
324 * @return string
Barry Mienydd671972010-10-04 16:33:58 +0200325 */
Andrey Andreevb76029d2012-01-26 15:13:19 +0200326 protected function _truncate($table)
Derek Allard2067d1a2008-11-13 22:59:24 +0000327 {
Andrey Andreeva6fe36e2012-04-05 16:00:32 +0300328 return 'DELETE FROM '.$table;
Derek Allard2067d1a2008-11-13 22:59:24 +0000329 }
Barry Mienydd671972010-10-04 16:33:58 +0200330
Derek Allard2067d1a2008-11-13 22:59:24 +0000331 // --------------------------------------------------------------------
332
333 /**
Derek Allard2067d1a2008-11-13 22:59:24 +0000334 * Close DB Connection
335 *
Derek Allard2067d1a2008-11-13 22:59:24 +0000336 * @return void
337 */
Andrey Andreev79922c02012-05-23 12:27:17 +0300338 protected function _close()
Derek Allard2067d1a2008-11-13 22:59:24 +0000339 {
Andrey Andreev79922c02012-05-23 12:27:17 +0300340 @odbc_close($this->conn_id);
Derek Allard2067d1a2008-11-13 22:59:24 +0000341 }
342
Derek Allard2067d1a2008-11-13 22:59:24 +0000343}
344
Derek Allard2067d1a2008-11-13 22:59:24 +0000345/* End of file odbc_driver.php */
Andrey Andreev79922c02012-05-23 12:27:17 +0300346/* Location: ./system/database/drivers/odbc/odbc_driver.php */