Subversion-Projekte lars-tiefland.ci

Revision

Revision 2242 | Revision 2257 | Zur aktuellen Revision | Details | Vergleich mit vorheriger | Letzte Änderung | Log anzeigen | RSS feed

Revision Autor Zeilennr. Zeile
68 lars 1
<?php
2
/**
3
 * CodeIgniter
4
 *
5
 * An open source application development framework for PHP
6
 *
7
 * This content is released under the MIT License (MIT)
8
 *
2254 lars 9
 * Copyright (c) 2014 - 2017, British Columbia Institute of Technology
68 lars 10
 *
11
 * Permission is hereby granted, free of charge, to any person obtaining a copy
12
 * of this software and associated documentation files (the "Software"), to deal
13
 * in the Software without restriction, including without limitation the rights
14
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
15
 * copies of the Software, and to permit persons to whom the Software is
16
 * furnished to do so, subject to the following conditions:
17
 *
18
 * The above copyright notice and this permission notice shall be included in
19
 * all copies or substantial portions of the Software.
20
 *
21
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
24
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
25
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
26
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
27
 * THE SOFTWARE.
28
 *
29
 * @package	CodeIgniter
30
 * @author	EllisLab Dev Team
31
 * @copyright	Copyright (c) 2008 - 2014, EllisLab, Inc. (https://ellislab.com/)
2254 lars 32
 * @copyright	Copyright (c) 2014 - 2017, British Columbia Institute of Technology (http://bcit.ca/)
68 lars 33
 * @license	http://opensource.org/licenses/MIT	MIT License
34
 * @link	https://codeigniter.com
35
 * @since	Version 1.3.0
36
 * @filesource
37
 */
38
defined('BASEPATH') OR exit('No direct script access allowed');
39
 
40
/**
41
 * MySQLi Database Adapter Class
42
 *
43
 * Note: _DB is an extender class that the app controller
44
 * creates dynamically based on whether the query builder
45
 * class is being used or not.
46
 *
47
 * @package		CodeIgniter
48
 * @subpackage	Drivers
49
 * @category	Database
50
 * @author		EllisLab Dev Team
51
 * @link		https://codeigniter.com/user_guide/database/
52
 */
53
class CI_DB_mysqli_driver extends CI_DB {
54
 
55
	/**
56
	 * Database driver
57
	 *
58
	 * @var	string
59
	 */
60
	public $dbdriver = 'mysqli';
61
 
62
	/**
63
	 * Compression flag
64
	 *
65
	 * @var	bool
66
	 */
67
	public $compress = FALSE;
68
 
69
	/**
70
	 * DELETE hack flag
71
	 *
72
	 * Whether to use the MySQL "delete hack" which allows the number
73
	 * of affected rows to be shown. Uses a preg_replace when enabled,
74
	 * adding a bit more processing to all queries.
75
	 *
76
	 * @var	bool
77
	 */
78
	public $delete_hack = TRUE;
79
 
80
	/**
81
	 * Strict ON flag
82
	 *
83
	 * Whether we're running in strict SQL mode.
84
	 *
85
	 * @var	bool
86
	 */
87
	public $stricton;
88
 
89
	// --------------------------------------------------------------------
90
 
91
	/**
92
	 * Identifier escape character
93
	 *
94
	 * @var	string
95
	 */
96
	protected $_escape_char = '`';
97
 
98
	// --------------------------------------------------------------------
99
 
100
	/**
101
	 * MySQLi object
102
	 *
103
	 * Has to be preserved without being assigned to $conn_id.
104
	 *
105
	 * @var	MySQLi
106
	 */
107
	protected $_mysqli;
108
 
109
	// --------------------------------------------------------------------
110
 
111
	/**
112
	 * Database connection
113
	 *
114
	 * @param	bool	$persistent
115
	 * @return	object
116
	 */
117
	public function db_connect($persistent = FALSE)
118
	{
119
		// Do we have a socket path?
120
		if ($this->hostname[0] === '/')
121
		{
122
			$hostname = NULL;
123
			$port = NULL;
124
			$socket = $this->hostname;
125
		}
126
		else
127
		{
1257 lars 128
			$hostname = ($persistent === TRUE)
68 lars 129
				? 'p:'.$this->hostname : $this->hostname;
130
			$port = empty($this->port) ? NULL : $this->port;
131
			$socket = NULL;
132
		}
133
 
134
		$client_flags = ($this->compress === TRUE) ? MYSQLI_CLIENT_COMPRESS : 0;
135
		$this->_mysqli = mysqli_init();
136
 
137
		$this->_mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 10);
138
 
139
		if (isset($this->stricton))
140
		{
141
			if ($this->stricton)
142
			{
143
				$this->_mysqli->options(MYSQLI_INIT_COMMAND, 'SET SESSION sql_mode = CONCAT(@@sql_mode, ",", "STRICT_ALL_TABLES")');
144
			}
145
			else
146
			{
147
				$this->_mysqli->options(MYSQLI_INIT_COMMAND,
148
					'SET SESSION sql_mode =
149
					REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(
150
					@@sql_mode,
151
					"STRICT_ALL_TABLES,", ""),
152
					",STRICT_ALL_TABLES", ""),
153
					"STRICT_ALL_TABLES", ""),
154
					"STRICT_TRANS_TABLES,", ""),
155
					",STRICT_TRANS_TABLES", ""),
156
					"STRICT_TRANS_TABLES", "")'
157
				);
158
			}
159
		}
160
 
161
		if (is_array($this->encrypt))
162
		{
163
			$ssl = array();
164
			empty($this->encrypt['ssl_key'])    OR $ssl['key']    = $this->encrypt['ssl_key'];
165
			empty($this->encrypt['ssl_cert'])   OR $ssl['cert']   = $this->encrypt['ssl_cert'];
166
			empty($this->encrypt['ssl_ca'])     OR $ssl['ca']     = $this->encrypt['ssl_ca'];
167
			empty($this->encrypt['ssl_capath']) OR $ssl['capath'] = $this->encrypt['ssl_capath'];
168
			empty($this->encrypt['ssl_cipher']) OR $ssl['cipher'] = $this->encrypt['ssl_cipher'];
169
 
170
			if ( ! empty($ssl))
171
			{
172
				if (isset($this->encrypt['ssl_verify']))
173
				{
174
					if ($this->encrypt['ssl_verify'])
175
					{
176
						defined('MYSQLI_OPT_SSL_VERIFY_SERVER_CERT') && $this->_mysqli->options(MYSQLI_OPT_SSL_VERIFY_SERVER_CERT, TRUE);
177
					}
178
					// Apparently (when it exists), setting MYSQLI_OPT_SSL_VERIFY_SERVER_CERT
179
					// to FALSE didn't do anything, so PHP 5.6.16 introduced yet another
180
					// constant ...
181
					//
182
					// https://secure.php.net/ChangeLog-5.php#5.6.16
183
					// https://bugs.php.net/bug.php?id=68344
184
					elseif (defined('MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT'))
185
					{
1257 lars 186
						$client_flags |= MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT;
68 lars 187
					}
188
				}
189
 
190
				$client_flags |= MYSQLI_CLIENT_SSL;
191
				$this->_mysqli->ssl_set(
192
					isset($ssl['key'])    ? $ssl['key']    : NULL,
193
					isset($ssl['cert'])   ? $ssl['cert']   : NULL,
194
					isset($ssl['ca'])     ? $ssl['ca']     : NULL,
195
					isset($ssl['capath']) ? $ssl['capath'] : NULL,
196
					isset($ssl['cipher']) ? $ssl['cipher'] : NULL
197
				);
198
			}
199
		}
200
 
201
		if ($this->_mysqli->real_connect($hostname, $this->username, $this->password, $this->database, $port, $socket, $client_flags))
202
		{
203
			// Prior to version 5.7.3, MySQL silently downgrades to an unencrypted connection if SSL setup fails
204
			if (
205
				($client_flags & MYSQLI_CLIENT_SSL)
206
				&& version_compare($this->_mysqli->client_info, '5.7.3', '<=')
207
				&& empty($this->_mysqli->query("SHOW STATUS LIKE 'ssl_cipher'")->fetch_object()->Value)
208
			)
209
			{
210
				$this->_mysqli->close();
211
				$message = 'MySQLi was configured for an SSL connection, but got an unencrypted connection instead!';
212
				log_message('error', $message);
2107 lars 213
				return ($this->db_debug) ? $this->display_error($message, '', TRUE) : FALSE;
68 lars 214
			}
215
 
216
			return $this->_mysqli;
217
		}
218
 
219
		return FALSE;
220
	}
221
 
222
	// --------------------------------------------------------------------
223
 
224
	/**
225
	 * Reconnect
226
	 *
227
	 * Keep / reestablish the db connection if no queries have been
228
	 * sent for a length of time exceeding the server's idle timeout
229
	 *
230
	 * @return	void
231
	 */
232
	public function reconnect()
233
	{
234
		if ($this->conn_id !== FALSE && $this->conn_id->ping() === FALSE)
235
		{
236
			$this->conn_id = FALSE;
237
		}
238
	}
239
 
240
	// --------------------------------------------------------------------
241
 
242
	/**
243
	 * Select the database
244
	 *
245
	 * @param	string	$database
246
	 * @return	bool
247
	 */
248
	public function db_select($database = '')
249
	{
250
		if ($database === '')
251
		{
252
			$database = $this->database;
253
		}
254
 
255
		if ($this->conn_id->select_db($database))
256
		{
257
			$this->database = $database;
258
			$this->data_cache = array();
259
			return TRUE;
260
		}
261
 
262
		return FALSE;
263
	}
264
 
265
	// --------------------------------------------------------------------
266
 
267
	/**
268
	 * Set client character set
269
	 *
270
	 * @param	string	$charset
271
	 * @return	bool
272
	 */
273
	protected function _db_set_charset($charset)
274
	{
275
		return $this->conn_id->set_charset($charset);
276
	}
277
 
278
	// --------------------------------------------------------------------
279
 
280
	/**
281
	 * Database version number
282
	 *
283
	 * @return	string
284
	 */
285
	public function version()
286
	{
287
		if (isset($this->data_cache['version']))
288
		{
289
			return $this->data_cache['version'];
290
		}
291
 
292
		return $this->data_cache['version'] = $this->conn_id->server_info;
293
	}
294
 
295
	// --------------------------------------------------------------------
296
 
297
	/**
298
	 * Execute the query
299
	 *
300
	 * @param	string	$sql	an SQL query
301
	 * @return	mixed
302
	 */
303
	protected function _execute($sql)
304
	{
305
		return $this->conn_id->query($this->_prep_query($sql));
306
	}
307
 
308
	// --------------------------------------------------------------------
309
 
310
	/**
311
	 * Prep the query
312
	 *
313
	 * If needed, each database adapter can prep the query string
314
	 *
315
	 * @param	string	$sql	an SQL query
316
	 * @return	string
317
	 */
318
	protected function _prep_query($sql)
319
	{
320
		// mysqli_affected_rows() returns 0 for "DELETE FROM TABLE" queries. This hack
321
		// modifies the query so that it a proper number of affected rows is returned.
322
		if ($this->delete_hack === TRUE && preg_match('/^\s*DELETE\s+FROM\s+(\S+)\s*$/i', $sql))
323
		{
324
			return trim($sql).' WHERE 1=1';
325
		}
326
 
327
		return $sql;
328
	}
329
 
330
	// --------------------------------------------------------------------
331
 
332
	/**
333
	 * Begin Transaction
334
	 *
335
	 * @return	bool
336
	 */
337
	protected function _trans_begin()
338
	{
339
		$this->conn_id->autocommit(FALSE);
340
		return is_php('5.5')
341
			? $this->conn_id->begin_transaction()
342
			: $this->simple_query('START TRANSACTION'); // can also be BEGIN or BEGIN WORK
343
	}
344
 
345
	// --------------------------------------------------------------------
346
 
347
	/**
348
	 * Commit Transaction
349
	 *
350
	 * @return	bool
351
	 */
352
	protected function _trans_commit()
353
	{
354
		if ($this->conn_id->commit())
355
		{
356
			$this->conn_id->autocommit(TRUE);
357
			return TRUE;
358
		}
359
 
360
		return FALSE;
361
	}
362
 
363
	// --------------------------------------------------------------------
364
 
365
	/**
366
	 * Rollback Transaction
367
	 *
368
	 * @return	bool
369
	 */
370
	protected function _trans_rollback()
371
	{
372
		if ($this->conn_id->rollback())
373
		{
374
			$this->conn_id->autocommit(TRUE);
375
			return TRUE;
376
		}
377
 
378
		return FALSE;
379
	}
380
 
381
	// --------------------------------------------------------------------
382
 
383
	/**
2107 lars 384
	 * Platform-dependent string escape
68 lars 385
	 *
386
	 * @param	string
387
	 * @return	string
388
	 */
389
	protected function _escape_str($str)
390
	{
391
		return $this->conn_id->real_escape_string($str);
392
	}
393
 
394
	// --------------------------------------------------------------------
395
 
396
	/**
397
	 * Affected Rows
398
	 *
399
	 * @return	int
400
	 */
401
	public function affected_rows()
402
	{
403
		return $this->conn_id->affected_rows;
404
	}
405
 
406
	// --------------------------------------------------------------------
407
 
408
	/**
409
	 * Insert ID
410
	 *
411
	 * @return	int
412
	 */
413
	public function insert_id()
414
	{
415
		return $this->conn_id->insert_id;
416
	}
417
 
418
	// --------------------------------------------------------------------
419
 
420
	/**
421
	 * List table query
422
	 *
423
	 * Generates a platform-specific query string so that the table names can be fetched
424
	 *
425
	 * @param	bool	$prefix_limit
426
	 * @return	string
427
	 */
428
	protected function _list_tables($prefix_limit = FALSE)
429
	{
430
		$sql = 'SHOW TABLES FROM '.$this->escape_identifiers($this->database);
431
 
432
		if ($prefix_limit !== FALSE && $this->dbprefix !== '')
433
		{
434
			return $sql." LIKE '".$this->escape_like_str($this->dbprefix)."%'";
435
		}
436
 
437
		return $sql;
438
	}
439
 
440
	// --------------------------------------------------------------------
441
 
442
	/**
443
	 * Show column query
444
	 *
445
	 * Generates a platform-specific query string so that the column names can be fetched
446
	 *
447
	 * @param	string	$table
448
	 * @return	string
449
	 */
450
	protected function _list_columns($table = '')
451
	{
452
		return 'SHOW COLUMNS FROM '.$this->protect_identifiers($table, TRUE, NULL, FALSE);
453
	}
454
 
455
	// --------------------------------------------------------------------
456
 
457
	/**
458
	 * Returns an object with field data
459
	 *
460
	 * @param	string	$table
461
	 * @return	array
462
	 */
463
	public function field_data($table)
464
	{
465
		if (($query = $this->query('SHOW COLUMNS FROM '.$this->protect_identifiers($table, TRUE, NULL, FALSE))) === FALSE)
466
		{
467
			return FALSE;
468
		}
469
		$query = $query->result_object();
470
 
471
		$retval = array();
472
		for ($i = 0, $c = count($query); $i < $c; $i++)
473
		{
474
			$retval[$i]			= new stdClass();
475
			$retval[$i]->name		= $query[$i]->Field;
476
 
477
			sscanf($query[$i]->Type, '%[a-z](%d)',
478
				$retval[$i]->type,
479
				$retval[$i]->max_length
480
			);
481
 
482
			$retval[$i]->default		= $query[$i]->Default;
483
			$retval[$i]->primary_key	= (int) ($query[$i]->Key === 'PRI');
484
		}
485
 
486
		return $retval;
487
	}
488
 
489
	// --------------------------------------------------------------------
490
 
491
	/**
492
	 * Error
493
	 *
494
	 * Returns an array containing code and message of the last
495
	 * database error that has occurred.
496
	 *
497
	 * @return	array
498
	 */
499
	public function error()
500
	{
501
		if ( ! empty($this->_mysqli->connect_errno))
502
		{
503
			return array(
1257 lars 504
				'code'    => $this->_mysqli->connect_errno,
505
				'message' => $this->_mysqli->connect_error
68 lars 506
			);
507
		}
508
 
509
		return array('code' => $this->conn_id->errno, 'message' => $this->conn_id->error);
510
	}
511
 
512
	// --------------------------------------------------------------------
513
 
514
	/**
515
	 * FROM tables
516
	 *
517
	 * Groups tables in FROM clauses if needed, so there is no confusion
518
	 * about operator precedence.
519
	 *
520
	 * @return	string
521
	 */
522
	protected function _from_tables()
523
	{
524
		if ( ! empty($this->qb_join) && count($this->qb_from) > 1)
525
		{
526
			return '('.implode(', ', $this->qb_from).')';
527
		}
528
 
529
		return implode(', ', $this->qb_from);
530
	}
531
 
532
	// --------------------------------------------------------------------
533
 
534
	/**
535
	 * Close DB Connection
536
	 *
537
	 * @return	void
538
	 */
539
	protected function _close()
540
	{
541
		$this->conn_id->close();
542
	}
543
 
544
}