blob: 4643cb2ac0024b81d2f1fafd598c5ab488460257 [file] [log] [blame]
Derek Allardd2df9bc2007-04-15 17:41:17 +00001<?php if (!defined('BASEPATH')) exit('No direct script access allowed');
2/**
3 * CodeIgniter
4 *
5 * An open source application development framework for PHP 4.3.2 or newer
6 *
7 * @package CodeIgniter
8 * @author Rick Ellis
9 * @copyright Copyright (c) 2006, EllisLab, Inc.
Derek Allard6838f002007-10-04 19:29:59 +000010 * @license http://www.codeigniter.com/user_guide/license.html
Derek Allardd2df9bc2007-04-15 17:41:17 +000011 * @link http://www.codeigniter.com
12 * @since Version 1.0
13 * @filesource
14 */
15
16// ------------------------------------------------------------------------
17
18/**
19 * MySQLi Database Adapter Class - MySQLi only works with PHP 5
20 *
21 * Note: _DB is an extender class that the app controller
22 * creates dynamically based on whether the active record
23 * class is being used or not.
24 *
25 * @package CodeIgniter
26 * @subpackage Drivers
27 * @category Database
28 * @author Rick Ellis
29 * @link http://www.codeigniter.com/user_guide/database/
30 */
31class CI_DB_mysqli_driver extends CI_DB {
32
33 /**
34 * Whether to use the MySQL "delete hack" which allows the number
35 * of affected rows to be shown. Uses a preg_replace when enabled,
36 * adding a bit more processing to all queries.
37 */
38 var $delete_hack = TRUE;
39
40 // --------------------------------------------------------------------
41
42 /**
43 * Non-persistent database connection
44 *
45 * @access private called by the base class
46 * @return resource
47 */
48 function db_connect()
49 {
50 return @mysqli_connect($this->hostname, $this->username, $this->password);
51 }
52
53 // --------------------------------------------------------------------
54
55 /**
56 * Persistent database connection
57 *
58 * @access private called by the base class
59 * @return resource
60 */
61 function db_pconnect()
62 {
63 return $this->db_connect();
64 }
65
66 // --------------------------------------------------------------------
67
68 /**
69 * Select the database
70 *
71 * @access private called by the base class
72 * @return resource
73 */
74 function db_select()
75 {
76 return @mysqli_select_db($this->conn_id, $this->database);
77 }
78
79 // --------------------------------------------------------------------
80
81 /**
82 * Version number query string
83 *
84 * @access public
85 * @return string
86 */
87 function _version()
88 {
89 return "SELECT version() AS ver";
90 }
91
92 // --------------------------------------------------------------------
93
94 /**
95 * Execute the query
96 *
97 * @access private called by the base class
98 * @param string an SQL query
99 * @return resource
100 */
101 function _execute($sql)
102 {
103 $sql = $this->_prep_query($sql);
104 $result = @mysqli_query($this->conn_id, $sql);
105 return $result;
106 }
107
108 // --------------------------------------------------------------------
109
110 /**
111 * Prep the query
112 *
113 * If needed, each database adapter can prep the query string
114 *
115 * @access private called by execute()
116 * @param string an SQL query
117 * @return string
118 */
119 function _prep_query($sql)
120 {
121 // "DELETE FROM TABLE" returns 0 affected rows This hack modifies
122 // the query so that it returns the number of affected rows
123 if ($this->delete_hack === TRUE)
124 {
125 if (preg_match('/^\s*DELETE\s+FROM\s+(\S+)\s*$/i', $sql))
126 {
127 $sql = preg_replace("/^\s*DELETE\s+FROM\s+(\S+)\s*$/", "DELETE FROM \\1 WHERE 1=1", $sql);
128 }
129 }
130
131 return $sql;
132 }
133
134 // --------------------------------------------------------------------
135
136 /**
137 * Begin Transaction
138 *
139 * @access public
140 * @return bool
141 */
142 function trans_begin($test_mode = FALSE)
143 {
144 if ( ! $this->trans_enabled)
145 {
146 return TRUE;
147 }
148
149 // When transactions are nested we only begin/commit/rollback the outermost ones
150 if ($this->_trans_depth > 0)
151 {
152 return TRUE;
153 }
154
155 // Reset the transaction failure flag.
156 // If the $test_mode flag is set to TRUE transactions will be rolled back
157 // even if the queries produce a successful result.
158 $this->_trans_failure = ($test_mode === TRUE) ? TRUE : FALSE;
159
160 $this->simple_query('SET AUTOCOMMIT=0');
161 $this->simple_query('START TRANSACTION'); // can also be BEGIN or BEGIN WORK
162 return TRUE;
163 }
164
165 // --------------------------------------------------------------------
166
167 /**
168 * Commit Transaction
169 *
170 * @access public
171 * @return bool
172 */
173 function trans_commit()
174 {
175 if ( ! $this->trans_enabled)
176 {
177 return TRUE;
178 }
179
180 // When transactions are nested we only begin/commit/rollback the outermost ones
181 if ($this->_trans_depth > 0)
182 {
183 return TRUE;
184 }
185
186 $this->simple_query('COMMIT');
187 $this->simple_query('SET AUTOCOMMIT=1');
188 return TRUE;
189 }
190
191 // --------------------------------------------------------------------
192
193 /**
194 * Rollback Transaction
195 *
196 * @access public
197 * @return bool
198 */
199 function trans_rollback()
200 {
201 if ( ! $this->trans_enabled)
202 {
203 return TRUE;
204 }
205
206 // When transactions are nested we only begin/commit/rollback the outermost ones
207 if ($this->_trans_depth > 0)
208 {
209 return TRUE;
210 }
211
212 $this->simple_query('ROLLBACK');
213 $this->simple_query('SET AUTOCOMMIT=1');
214 return TRUE;
215 }
216
217 // --------------------------------------------------------------------
218
219 /**
220 * Escape String
221 *
222 * @access public
223 * @param string
224 * @return string
225 */
226 function escape_str($str)
227 {
Derek Allardd2df9bc2007-04-15 17:41:17 +0000228 return mysqli_real_escape_string($this->conn_id, $str);
229 }
230
231 // --------------------------------------------------------------------
232
233 /**
234 * Affected Rows
235 *
236 * @access public
237 * @return integer
238 */
239 function affected_rows()
240 {
241 return @mysqli_affected_rows($this->conn_id);
242 }
243
244 // --------------------------------------------------------------------
245
246 /**
247 * Insert ID
248 *
249 * @access public
250 * @return integer
251 */
252 function insert_id()
253 {
254 return @mysqli_insert_id($this->conn_id);
255 }
256
257 // --------------------------------------------------------------------
258
259 /**
260 * "Count All" query
261 *
262 * Generates a platform-specific query string that counts all records in
263 * the specified database
264 *
265 * @access public
266 * @param string
267 * @return string
268 */
269 function count_all($table = '')
270 {
271 if ($table == '')
272 return '0';
273
274 $query = $this->query("SELECT COUNT(*) AS numrows FROM `".$this->dbprefix.$table."`");
275
276 if ($query->num_rows() == 0)
277 return '0';
278
279 $row = $query->row();
280 return $row->numrows;
281 }
282
283 // --------------------------------------------------------------------
284
285 /**
286 * List table query
287 *
288 * Generates a platform-specific query string so that the table names can be fetched
289 *
290 * @access private
291 * @return string
292 */
293 function _list_tables()
294 {
295 return "SHOW TABLES FROM `".$this->database."`";
296 }
297
298 // --------------------------------------------------------------------
299
300 /**
301 * Show column query
302 *
303 * Generates a platform-specific query string so that the column names can be fetched
304 *
305 * @access public
306 * @param string the table name
307 * @return string
308 */
309 function _list_columns($table = '')
310 {
311 return "SHOW COLUMNS FROM ".$this->_escape_table($table);
312 }
313
314 // --------------------------------------------------------------------
315
316 /**
317 * Field data query
318 *
319 * Generates a platform-specific query so that the column data can be retrieved
320 *
321 * @access public
322 * @param string the table name
323 * @return object
324 */
325 function _field_data($table)
326 {
327 return "SELECT * FROM ".$this->_escape_table($table)." LIMIT 1";
328 }
329
330 // --------------------------------------------------------------------
331
332 /**
333 * The error message string
334 *
335 * @access private
336 * @return string
337 */
338 function _error_message()
339 {
340 return mysqli_error($this->conn_id);
341 }
342
343 // --------------------------------------------------------------------
344
345 /**
346 * The error message number
347 *
348 * @access private
349 * @return integer
350 */
351 function _error_number()
352 {
353 return mysqli_errno($this->conn_id);
354 }
355
356 // --------------------------------------------------------------------
357
358 /**
359 * Escape Table Name
360 *
361 * This function adds backticks if the table name has a period
362 * in it. Some DBs will get cranky unless periods are escaped
363 *
364 * @access private
365 * @param string the table name
366 * @return string
367 */
368 function _escape_table($table)
369 {
370 if (stristr($table, '.'))
371 {
372 $table = preg_replace("/\./", "`.`", $table);
373 }
374
375 return $table;
376 }
377
378 // --------------------------------------------------------------------
379
380 /**
381 * Insert statement
382 *
383 * Generates a platform-specific insert string from the supplied data
384 *
385 * @access public
386 * @param string the table name
387 * @param array the insert keys
388 * @param array the insert values
389 * @return string
390 */
391 function _insert($table, $keys, $values)
392 {
393 return "INSERT INTO ".$this->_escape_table($table)." (".implode(', ', $keys).") VALUES (".implode(', ', $values).")";
394 }
395
396 // --------------------------------------------------------------------
397
398 /**
399 * Update statement
400 *
401 * Generates a platform-specific update string from the supplied data
402 *
403 * @access public
404 * @param string the table name
405 * @param array the update data
406 * @param array the where clause
407 * @return string
408 */
409 function _update($table, $values, $where)
410 {
411 foreach($values as $key => $val)
412 {
413 $valstr[] = $key." = ".$val;
414 }
415
416 return "UPDATE ".$this->_escape_table($table)." SET ".implode(', ', $valstr)." WHERE ".implode(" ", $where);
417 }
418
419 // --------------------------------------------------------------------
420
421 /**
422 * Delete statement
423 *
424 * Generates a platform-specific delete string from the supplied data
425 *
426 * @access public
427 * @param string the table name
428 * @param array the where clause
429 * @return string
430 */
431 function _delete($table, $where)
432 {
433 return "DELETE FROM ".$this->_escape_table($table)." WHERE ".implode(" ", $where);
434 }
435
436 // --------------------------------------------------------------------
437
438 /**
439 * Limit string
440 *
441 * Generates a platform-specific LIMIT clause
442 *
443 * @access public
444 * @param string the sql query string
445 * @param integer the number of rows to limit the query to
446 * @param integer the offset value
447 * @return string
448 */
449 function _limit($sql, $limit, $offset)
450 {
451 $sql .= "LIMIT ".$limit;
452
453 if ($offset > 0)
454 {
455 $sql .= " OFFSET ".$offset;
456 }
457
458 return $sql;
459 }
460
461 // --------------------------------------------------------------------
462
463 /**
464 * Close DB Connection
465 *
466 * @access public
467 * @param resource
468 * @return void
469 */
470 function _close($conn_id)
471 {
472 @mysqli_close($conn_id);
473 }
474
475
476}
477
adminff2d2512006-09-24 18:12:18 +0000478?>