1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 58: 59: 60: 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: 74: 75: 76: 77: 78: 79: 80: 81: 82: 83: 84: 85: 86: 87: 88: 89: 90: 91: 92: 93: 94: 95: 96: 97: 98: 99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: 133: 134: 135: 136: 137: 138: 139: 140: 141: 142: 143: 144: 145: 146: 147: 148: 149: 150: 151: 152: 153: 154: 155: 156: 157: 158: 159: 160: 161: 162: 163: 164: 165: 166: 167: 168: 169: 170: 171: 172: <?php
// ------------------------------------------------------------------------ //
// XOOPS - PHP Content Management System //
// Copyright (c) 2000 XOOPS.org //
// <http://www.xoops.org/> //
// ------------------------------------------------------------------------ //
// This program is free software; you can redistribute it and/or modify //
// it under the terms of the GNU General Public License as published by //
// the Free Software Foundation; either version 2 of the License, or //
// (at your option) any later version. //
// //
// You may not change or alter any portion of this comment or credits //
// of supporting developers from this source code or any supporting //
// source code which is considered copyrighted (c) material of the //
// original comment or credit authors. //
// //
// This program is distributed in the hope that it will be useful, //
// but WITHOUT ANY WARRANTY; without even the implied warranty of //
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the //
// GNU General Public License for more details. //
// //
// You should have received a copy of the GNU General Public License //
// along with this program; if not, write to the Free Software //
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA //
// ------------------------------------------------------------------------ //
// Author: Kazumi Ono (AKA onokazu) //
// URL: http://www.myweb.ne.jp/, http://www.xoops.org/, http://jp.xoops.org/ //
// Project: The XOOPS Project //
// ------------------------------------------------------------------------- //
/**
* Establishes database class and connection
*
* @category ICMS
* @package Database
*
* @copyright The ImpressCMS Project <http://www.impresscms.org>
* @license http://www.gnu.org/licenses/old-licenses/gpl-2.0.html GNU General Public License (GPL)
*/
/**
*
* @category ICMS
* @package Database
*
* @copyright copyright (c) 2000-2007 XOOPS.org
* @copyright The ImpressCMS Project <http://www.impresscms.org>
*
* @abstract
*/
abstract class icms_db_Factory {
/**
* PDO database adapter. It represents a PDO connection only
* Access this as icms::$db
*
* @copyright The ImpressCMS Project <http://www.impresscms.org>
* @var icms_db_IConnection
*/
static protected $pdoInstance = FALSE;
/**
* Legacy database adapter - it can represent a legacy database connection or a PDO connection.
* Access this as icms::$xoopsDB
*
* @var icms_db_legacy_Database
*/
static protected $xoopsInstance = FALSE;
/**
* Instanciate the PDO compatible DB adapter (if appropriate).
*
* @copyright The ImpressCMS Project <http://www.impresscms.org>
*
* @throws RuntimeException
*/
public static function pdoInstance() {
if (self::$pdoInstance !== FALSE) {
return self::$pdoInstance;
}
if (strpos(XOOPS_DB_TYPE, 'pdo.') !== 0) {
return self::$pdoInstance = NULL;
}
if (!class_exists('PDO', FALSE)) {
throw new RuntimeException("PDO extension not available.");
}
// --> added by Claudia, ImpressCMS.org
$string_conn = "host=". XOOPS_DB_HOST . ";dbname=". XOOPS_DB_NAME;
if (defined ('ICMS_DB_PORT')) {
$string_conn .= ';port='. ICMS_DB_PORT;
}
if (XOOPS_DB_CHARSET) {
$string_conn .= ';charset=' . XOOPS_DB_CHARSET;
}
define ('ICMS_DB_DSN', $string_conn);
// <--
/* this is an array of attributes to pass to the connection before it is established */
$options = array(
PDO::ATTR_ERRMODE => PDO::ERRMODE_SILENT, // default is ERRMODE_SILENT (returns error code, only)
);
/* Note: from PHP PDO connections documentation - http://www.php.net/manual/en/pdo.connections.php
*
* If you're using the PDO ODBC driver and your ODBC libraries support ODBC
* Connection Pooling (unixODBC and Windows are two that do; there may be more),
* then it's recommended that you don't use persistent PDO connections,
* and instead leave the connection caching to the ODBC Connection Pooling layer.
* The ODBC Connection Pool is shared with other modules in the process;
* if PDO is told to cache the connection, then that connection would never be returned
* to the ODBC connection pool, resulting in additional connections being created
* to service those other modules.
*
* If you are certain releases of PHP 5.4 you cannot use persistent connections
* when you have your own database class that derives from the native PDO object.
* If you do, you will get segmentation faults during the PHP process shutdown.
* Please see this bug report for more information: https://bugs.php.net/bug.php?id=63176
*/
if (XOOPS_DB_PCONNECT == 1) {
$options[PDO::ATTR_PERSISTENT] = TRUE;
} else {
$options[PDO::ATTR_PERSISTENT] = FALSE;
}
$driver = substr(XOOPS_DB_TYPE, 4);
$dsn = $driver . ':' . ICMS_DB_DSN;
$class = "icms_db_{$driver}_Connection";
if (!class_exists($class)) {
$class = "icms_db_Connection";
}
return self::$pdoInstance = new $class($dsn, XOOPS_DB_USER, XOOPS_DB_PASS, $options);
}
/**
* Get a reference to the only instance of database class and connects to DB
*
* if the class has not been instantiated yet, this will also take
* care of that
*
* @copyright copyright (c) 2000-2007 XOOPS.org
* @author modified by arcandier, The ImpressCMS Project
*
* @static
* @return object Reference to the only instance of database class
*/
public static function instance() {
if (self::$xoopsInstance !== FALSE) return self::$xoopsInstance;
$allowWebChanges = defined('XOOPS_DB_PROXY') ? FALSE : TRUE;
if (strpos(XOOPS_DB_TYPE, 'pdo.') === 0) {
if (FALSE === self::$pdoInstance) self::pdoInstance();
self::$xoopsInstance = new icms_db_legacy_PdoDatabase(self::$pdoInstance, $allowWebChanges);
} else {
if (defined('XOOPS_DB_ALTERNATIVE') && class_exists(XOOPS_DB_ALTERNATIVE)) {
$class = XOOPS_DB_ALTERNATIVE;
} else {
$class = 'icms_db_legacy_' . XOOPS_DB_TYPE;
$class .= $allowWebChanges ? '_Safe' : '_Proxy';
}
self::$xoopsInstance = new $class();
/* during a new installation, the icms object does not exist */
//self::$xoopsInstance->setLogger(icms::$logger);
/* @todo remove the dependency on the logger class */
self::$xoopsInstance->setLogger(icms_core_Logger::instance());
if (!self::$xoopsInstance->connect()) {
/* this requires that include/functions.php has been loaded */
icms_loadLanguageFile('core', 'core');
trigger_error(_CORE_DB_NOTRACEDB, E_USER_ERROR);
}
}
self::$xoopsInstance->setPrefix(XOOPS_DB_PREFIX);
return self::$xoopsInstance;
}
}