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
|
<?php
/**
* SessionHandler:: defines an API for implementing custom session
* handlers for PHP.
*
* $Horde: horde/lib/SessionHandler.php,v 1.5.2.3 2003/04/28 19:59:08 jan Exp $
*
* Copyright 2002-2003 Mike Cochrane <mike@graftonhall.co.nz>
*
* See the enclosed file COPYING for license information (LGPL). If you
* did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
*
* @author Mike Cochrane <mike@graftonhall.co.nz>
* @version $Revision: 1.5.2.3 $
* @since Horde 2.2
* @package horde.sessionhandler
*/
class SessionHandler {
/**
* Attempts to return a concrete SessionHandler instance based on
* $driver.
*
* @param string $driver The type of concrete SessionHandler
* subclass to return. The is based on the
* driver ($driver). The code is
* dynamically included.
* @param optional array $params A hash containing any additional
* configuration or connection parameters
* a subclass might need.
*
* @return mixed The newly created concrete SessionHandler instance, or
* false on an error.
*/
function &factory($driver, $params = null)
{
if (is_array($driver)) {
$app = $driver[0];
$driver = $driver[1];
}
$driver = basename($driver);
if (is_null($params)) {
require_once dirname(__FILE__) . '/Horde.php';
$params = SessionHandler::_getDriverConfig('prefs', $driver);
}
if (!empty($app)) {
require_once $GLOBALS['registry']->getParam('fileroot', $app) . '/lib/SessionHandler/' . $driver . '.php';
} elseif (@file_exists(dirname(__FILE__) . '/SessionHandler/' . $driver . '.php')) {
require_once dirname(__FILE__) . '/SessionHandler/' . $driver . '.php';
} else {
@include_once 'Horde/SessionHandler/' . $driver . '.php';
}
$class = 'SessionHandler_' . $driver;
if (class_exists($class)) {
return new $class($params);
} else {
return PEAR::raiseError('Class definition of ' . $class . ' not found.');
}
}
/**
* Attempts to return a reference to a concrete SessionHandler
* instance based on $driver. It will only create a new instance
* if no SessionHandler instance with the same parameters
* currently exists.
*
* This method must be invoked as: $var = &SessionHandler::singleton()
*
* @param string $driver See SessionHandler::factory().
* @param optional array $params See SessionHandler::factory().
*
* @return mixed The created concrete SessionHandler instance, or false
* on error.
*/
function &singleton($driver, $params = null)
{
static $instances;
if (!isset($instances)) {
$instances = array();
}
if (is_null($params)) {
require_once dirname(__FILE__) . '/Horde.php';
$params = SessionHandler::_getDriverConfig('sessionhandler', $driver);
}
$signature = serialize(array($driver, $params));
if (!array_key_exists($signature, $instances)) {
$instances[$signature] = &SessionHandler::factory($driver, $params);
}
return $instances[$signature];
}
/**
* Return the driver parameters for the specified backend.
*
* @access private
*
* @param string $backend The backend system - prefs, categories,
* contacts - being used.
* @param optional string $type The type of driver. Defaults to 'sql'.
*
* @return array The connection parameters.
*/
function _getDriverConfig($backend, $type = 'sql')
{
global $conf;
if (array_key_exists($backend, $conf) &&
array_key_exists('params', $conf[$backend])) {
if (array_key_exists($type, $conf)) {
return array_merge($conf[$type], $conf[$backend]['params']);
} else {
return $conf[$backend]['params'];
}
}
return array_key_exists($type, $conf) ? $conf[$type] : array();
}
}
|
