5 V5.14 8 Sept 2011 (c) 2000-2011 John Lim (jlim#natsoft.com). All rights reserved.
6 Contributed by Ross Smith (adodb@netebb.com).
7 Released under both BSD license and Lesser GPL library license.
8 Whenever there is any discrepancy between the two licenses,
9 the BSD license will take precedence.
10 Set tabs to 4 for best viewing.
22 CREATE TABLE SESSIONS2
24 SESSKEY VARCHAR2(48 BYTE) NOT NULL,
26 EXPIREREF VARCHAR2(200 BYTE),
27 CREATED DATE NOT NULL,
28 MODIFIED DATE NOT NULL,
34 CREATE INDEX SESS2_EXPIRY ON SESSIONS2(EXPIRY);
35 CREATE UNIQUE INDEX SESS2_PK ON SESSIONS2(SESSKEY);
36 CREATE INDEX SESS2_EXP_REF ON SESSIONS2(EXPIREREF);
43 CREATE TABLE sessions2(
44 sesskey VARCHAR( 64 ) NOT NULL DEFAULT '',
45 expiry TIMESTAMP NOT NULL ,
46 expireref VARCHAR( 250 ) DEFAULT '',
47 created TIMESTAMP NOT NULL ,
48 modified TIMESTAMP NOT NULL ,
49 sessdata LONGTEXT DEFAULT '',
50 PRIMARY KEY ( sesskey ) ,
51 INDEX sess2_expiry( expiry ),
52 INDEX sess2_expireref( expireref )
58 if (!defined('_ADODB_LAYER')) {
59 require realpath(dirname(__FILE__
) . '/../adodb.inc.php');
62 if (defined('ADODB_SESSION')) return 1;
64 define('ADODB_SESSION', dirname(__FILE__
));
65 define('ADODB_SESSION2', ADODB_SESSION
);
68 Unserialize session data manually. See http://phplens.com/lens/lensforum/msgs.php?id=9821
70 From Kerr Schere, to unserialize session data stored via ADOdb.
71 1. Pull the session data from the db and loop through it.
72 2. Inside the loop, you will need to urldecode the data column.
73 3. After urldecode, run the serialized string through this function:
76 function adodb_unserialize( $serialized_string )
78 $variables = array( );
79 $a = preg_split( "/(\w+)\|/", $serialized_string, -1, PREG_SPLIT_NO_EMPTY | PREG_SPLIT_DELIM_CAPTURE
);
80 for( $i = 0; $i < count( $a ); $i = $i+
2 ) {
81 $variables[$a[$i]] = unserialize( $a[$i+
1] );
87 Thanks Joe Li. See http://phplens.com/lens/lensforum/msgs.php?id=11487&x=1
90 function adodb_session_regenerate_id()
92 $conn = ADODB_Session
::_conn();
93 if (!$conn) return false;
95 $old_id = session_id();
96 if (function_exists('session_regenerate_id')) {
97 session_regenerate_id();
99 session_id(md5(uniqid(rand(), true)));
100 $ck = session_get_cookie_params();
101 setcookie(session_name(), session_id(), false, $ck['path'], $ck['domain'], $ck['secure']);
104 $new_id = session_id();
105 $ok = $conn->Execute('UPDATE '. ADODB_Session
::table(). ' SET sesskey='. $conn->qstr($new_id). ' WHERE sesskey='.$conn->qstr($old_id));
107 /* it is possible that the update statement fails due to a collision */
110 if (empty($ck)) $ck = session_get_cookie_params();
111 setcookie(session_name(), session_id(), false, $ck['path'], $ck['domain'], $ck['secure']);
119 Generate database table for session data
120 @see http://phplens.com/lens/lensforum/msgs.php?id=12280
121 @return 0 if failure, 1 if errors, 2 if successful.
122 @author Markus Staab http://www.public-4u.de
124 function adodb_session_create_table($schemaFile=null,$conn = null)
126 // set default values
127 if ($schemaFile===null) $schemaFile = ADODB_SESSION
. '/session_schema2.xml';
128 if ($conn===null) $conn = ADODB_Session
::_conn();
130 if (!$conn) return 0;
132 $schema = new adoSchema($conn);
133 $schema->ParseSchema($schemaFile);
134 return $schema->ExecuteSchema();
140 class ADODB_Session
{
141 /////////////////////
142 // getter/setter methods
143 /////////////////////
147 function Lock($lock=null)
149 static $_lock = false;
151 if (!is_null($lock)) $_lock = $lock;
157 static function driver($driver = null)
159 static $_driver = 'mysql';
162 if (!is_null($driver)) {
163 $_driver = trim($driver);
166 // backwards compatibility
167 if (isset($GLOBALS['ADODB_SESSION_DRIVER'])) {
168 return $GLOBALS['ADODB_SESSION_DRIVER'];
177 static function host($host = null) {
178 static $_host = 'localhost';
181 if (!is_null($host)) {
182 $_host = trim($host);
185 // backwards compatibility
186 if (isset($GLOBALS['ADODB_SESSION_CONNECT'])) {
187 return $GLOBALS['ADODB_SESSION_CONNECT'];
196 static function user($user = null)
198 static $_user = 'root';
201 if (!is_null($user)) {
202 $_user = trim($user);
205 // backwards compatibility
206 if (isset($GLOBALS['ADODB_SESSION_USER'])) {
207 return $GLOBALS['ADODB_SESSION_USER'];
216 static function password($password = null)
218 static $_password = '';
221 if (!is_null($password)) {
222 $_password = $password;
225 // backwards compatibility
226 if (isset($GLOBALS['ADODB_SESSION_PWD'])) {
227 return $GLOBALS['ADODB_SESSION_PWD'];
236 static function database($database = null)
238 static $_database = '';
241 if (!is_null($database)) {
242 $_database = trim($database);
245 // backwards compatibility
246 if (isset($GLOBALS['ADODB_SESSION_DB'])) {
247 return $GLOBALS['ADODB_SESSION_DB'];
255 static function persist($persist = null)
257 static $_persist = true;
259 if (!is_null($persist)) {
260 $_persist = trim($persist);
268 static function lifetime($lifetime = null)
273 if (!is_null($lifetime)) {
274 $_lifetime = (int) $lifetime;
277 // backwards compatibility
278 if (isset($GLOBALS['ADODB_SESS_LIFE'])) {
279 return $GLOBALS['ADODB_SESS_LIFE'];
283 $_lifetime = ini_get('session.gc_maxlifetime');
284 if ($_lifetime <= 1) {
285 // bug in PHP 4.0.3 pl 1 -- how about other versions?
286 //print "<h3>Session Error: PHP.INI setting <i>session.gc_maxlifetime</i>not set: $lifetime</h3>";
296 static function debug($debug = null)
298 static $_debug = false;
301 if (!is_null($debug)) {
302 $_debug = (bool) $debug;
304 $conn = ADODB_Session
::_conn();
306 #$conn->debug = $_debug;
310 // backwards compatibility
311 if (isset($GLOBALS['ADODB_SESS_DEBUG'])) {
312 return $GLOBALS['ADODB_SESS_DEBUG'];
321 static function expireNotify($expire_notify = null)
323 static $_expire_notify;
326 if (!is_null($expire_notify)) {
327 $_expire_notify = $expire_notify;
330 // backwards compatibility
331 if (isset($GLOBALS['ADODB_SESSION_EXPIRE_NOTIFY'])) {
332 return $GLOBALS['ADODB_SESSION_EXPIRE_NOTIFY'];
336 return $_expire_notify;
341 static function table($table = null)
343 static $_table = 'sessions2';
346 if (!is_null($table)) {
347 $_table = trim($table);
350 // backwards compatibility
351 if (isset($GLOBALS['ADODB_SESSION_TBL'])) {
352 return $GLOBALS['ADODB_SESSION_TBL'];
361 static function optimize($optimize = null)
363 static $_optimize = false;
366 if (!is_null($optimize)) {
367 $_optimize = (bool) $optimize;
370 // backwards compatibility
371 if (defined('ADODB_SESSION_OPTIMIZE')) {
381 static function syncSeconds($sync_seconds = null) {
382 //echo ("<p>WARNING: ADODB_SESSION::syncSeconds is longer used, please remove this function for your code</p>");
389 static function clob($clob = null) {
390 static $_clob = false;
393 if (!is_null($clob)) {
394 $_clob = strtolower(trim($clob));
397 // backwards compatibility
398 if (isset($GLOBALS['ADODB_SESSION_USE_LOBS'])) {
399 return $GLOBALS['ADODB_SESSION_USE_LOBS'];
408 static function dataFieldName($data_field_name = null) {
409 //echo ("<p>WARNING: ADODB_SESSION::dataFieldName() is longer used, please remove this function for your code</p>");
415 static function filter($filter = null) {
416 static $_filter = array();
418 if (!is_null($filter)) {
419 if (!is_array($filter)) {
420 $filter = array($filter);
430 static function encryptionKey($encryption_key = null) {
431 static $_encryption_key = 'CRYPTED ADODB SESSIONS ROCK!';
433 if (!is_null($encryption_key)) {
434 $_encryption_key = $encryption_key;
437 return $_encryption_key;
440 /////////////////////
442 /////////////////////
446 static function _conn($conn=null) {
447 return isset($GLOBALS['ADODB_SESS_CONN']) ?
$GLOBALS['ADODB_SESS_CONN'] : false;
452 static function _crc($crc = null) {
453 static $_crc = false;
455 if (!is_null($crc)) {
464 static function _init() {
465 session_module_name('user');
466 session_set_save_handler(
467 array('ADODB_Session', 'open'),
468 array('ADODB_Session', 'close'),
469 array('ADODB_Session', 'read'),
470 array('ADODB_Session', 'write'),
471 array('ADODB_Session', 'destroy'),
472 array('ADODB_Session', 'gc')
479 static function _sessionKey() {
480 // use this function to create the encryption key for crypted sessions
481 // crypt the used key, ADODB_Session::encryptionKey() as key and session_id() as salt
482 return crypt(ADODB_Session
::encryptionKey(), session_id());
487 static function _dumprs(&$rs) {
488 $conn = ADODB_Session
::_conn();
489 $debug = ADODB_Session
::debug();
500 echo "<br />\$rs is null or false<br />\n";
504 //echo "<br />\nAffected_Rows=",$conn->Affected_Rows(),"<br />\n";
506 if (!is_object($rs)) {
509 $rs = $conn->_rs2rs($rs);
511 require_once ADODB_SESSION
.'/../tohtml.inc.php';
516 /////////////////////
518 /////////////////////
520 static function config($driver, $host, $user, $password, $database=false,$options=false)
522 ADODB_Session
::driver($driver);
523 ADODB_Session
::host($host);
524 ADODB_Session
::user($user);
525 ADODB_Session
::password($password);
526 ADODB_Session
::database($database);
528 if ($driver == 'oci8' ||
$driver == 'oci8po') $options['lob'] = 'CLOB';
530 if (isset($options['table'])) ADODB_Session
::table($options['table']);
531 if (isset($options['lob'])) ADODB_Session
::clob($options['lob']);
532 if (isset($options['debug'])) ADODB_Session
::debug($options['debug']);
536 Create the connection to the database.
538 If $conn already exists, reuse that connection
540 static function open($save_path, $session_name, $persist = null)
542 $conn = ADODB_Session
::_conn();
548 $database = ADODB_Session
::database();
549 $debug = ADODB_Session
::debug();
550 $driver = ADODB_Session
::driver();
551 $host = ADODB_Session
::host();
552 $password = ADODB_Session
::password();
553 $user = ADODB_Session
::user();
555 if (!is_null($persist)) {
556 ADODB_Session
::persist($persist);
558 $persist = ADODB_Session
::persist();
561 # these can all be defaulted to in php.ini
562 # assert('$database');
566 $conn = ADONewConnection($driver);
570 ADOConnection
::outp( " driver=$driver user=$user db=$database ");
573 if (empty($conn->_connectionID
)) { // not dsn
577 case 'P': $ok = $conn->PConnect($host, $user, $password, $database); break;
578 case 'C': $ok = $conn->Connect($host, $user, $password, $database); break;
579 case 'N': $ok = $conn->NConnect($host, $user, $password, $database); break;
582 $ok = $conn->Connect($host, $user, $password, $database);
586 if ($ok) $GLOBALS['ADODB_SESS_CONN'] = $conn;
588 ADOConnection
::outp('<p>Session: connection failed</p>', false);
597 static function close()
600 $conn = ADODB_Session::_conn();
601 if ($conn) $conn->Close();
607 Slurp in the session variables and return the serialized string
609 static function read($key)
611 $conn = ADODB_Session
::_conn();
612 $filter = ADODB_Session
::filter();
613 $table = ADODB_Session
::table();
621 $binary = $conn->dataProvider
=== 'mysql' ?
'/*! BINARY */' : '';
623 $sql = "SELECT sessdata FROM $table WHERE sesskey = $binary ".$conn->Param(0)." AND expiry >= " . $conn->sysTimeStamp
;
624 /* Lock code does not work as it needs to hold transaction within whole page, and we don't know if
625 developer has commited elsewhere... :(
627 #if (ADODB_Session::Lock())
628 # $rs = $conn->RowLock($table, "$binary sesskey = $qkey AND expiry >= " . time(), sessdata);
630 $rs = $conn->Execute($sql, array($key));
631 //ADODB_Session::_dumprs($rs);
636 $v = reset($rs->fields
);
637 $filter = array_reverse($filter);
638 foreach ($filter as $f) {
640 $v = $f->read($v, ADODB_Session
::_sessionKey());
643 $v = rawurldecode($v);
648 ADODB_Session
::_crc(strlen($v) . crc32($v));
656 Write the serialized data to a database.
658 If the data has not been modified since the last read(), we do not write.
660 static function write($key, $oval)
662 global $ADODB_SESSION_READONLY;
664 if (!empty($ADODB_SESSION_READONLY)) return;
666 $clob = ADODB_Session
::clob();
667 $conn = ADODB_Session
::_conn();
668 $crc = ADODB_Session
::_crc();
669 $debug = ADODB_Session
::debug();
670 $driver = ADODB_Session
::driver();
671 $expire_notify = ADODB_Session
::expireNotify();
672 $filter = ADODB_Session
::filter();
673 $lifetime = ADODB_Session
::lifetime();
674 $table = ADODB_Session
::table();
679 if ($debug) $conn->debug
= 1;
680 $sysTimeStamp = $conn->sysTimeStamp
;
684 $expiry = $conn->OffsetDate($lifetime/(24*3600),$sysTimeStamp);
686 $binary = $conn->dataProvider
=== 'mysql' ?
'/*! BINARY */' : '';
688 // crc32 optimization since adodb 2.1
689 // now we only update expiry date, thx to sebastian thom in adodb 2.32
690 if ($crc !== false && $crc == (strlen($oval) . crc32($oval))) {
692 echo '<p>Session: Only updating date - crc32 not changed</p>';
696 if ($expire_notify) {
697 $var = reset($expire_notify);
705 $sql = "UPDATE $table SET expiry = $expiry ,expireref=".$conn->Param('0').", modified = $sysTimeStamp WHERE $binary sesskey = ".$conn->Param('1')." AND expiry >= $sysTimeStamp";
706 $rs = $conn->Execute($sql,array($expirevar,$key));
709 $val = rawurlencode($oval);
710 foreach ($filter as $f) {
712 $val = $f->write($val, ADODB_Session
::_sessionKey());
717 if ($expire_notify) {
718 $var = reset($expire_notify);
725 if (!$clob) { // no lobs, simply use replace()
726 $rs = $conn->Execute("SELECT COUNT(*) AS cnt FROM $table WHERE $binary sesskey = ".$conn->Param(0),array($key));
727 if ($rs) $rs->Close();
729 if ($rs && reset($rs->fields
) > 0) {
730 $sql = "UPDATE $table SET expiry=$expiry, sessdata=".$conn->Param(0).", expireref= ".$conn->Param(1).",modified=$sysTimeStamp WHERE sesskey = ".$conn->Param(2);
733 $sql = "INSERT INTO $table (expiry, sessdata, expireref, sesskey, created, modified)
734 VALUES ($expiry,".$conn->Param('0').", ". $conn->Param('1').", ".$conn->Param('2').", $sysTimeStamp, $sysTimeStamp)";
738 $rs = $conn->Execute($sql,array($val,$expireref,$key));
741 // what value shall we insert/update for lob row?
743 // empty_clob or empty_lob for oracle dbs
748 $lob_value = sprintf('empty_%s()', strtolower($clob));
751 // null for all other
759 $rs = $conn->Execute("SELECT COUNT(*) AS cnt FROM $table WHERE $binary sesskey = ".$conn->Param(0),array($key));
761 if ($rs && reset($rs->fields
) > 0) {
762 $sql = "UPDATE $table SET expiry=$expiry, sessdata=$lob_value, expireref= ".$conn->Param(0).",modified=$sysTimeStamp WHERE sesskey = ".$conn->Param('1');
765 $sql = "INSERT INTO $table (expiry, sessdata, expireref, sesskey, created, modified)
766 VALUES ($expiry,$lob_value, ". $conn->Param('0').", ".$conn->Param('1').", $sysTimeStamp, $sysTimeStamp)";
769 $rs = $conn->Execute($sql,array($expireref,$key));
771 $qkey = $conn->qstr($key);
772 $rs2 = $conn->UpdateBlob($table, 'sessdata', $val, " sesskey=$qkey", strtoupper($clob));
773 if ($debug) echo "<hr>",htmlspecialchars($oval), "<hr>";
774 $rs = @$conn->CompleteTrans();
780 ADOConnection
::outp('<p>Session Replace: ' . $conn->ErrorMsg() . '</p>', false);
783 // bug in access driver (could be odbc?) means that info is not committed
784 // properly unless select statement executed in Win2000
785 if ($conn->databaseType
== 'access') {
786 $sql = "SELECT sesskey FROM $table WHERE $binary sesskey = $qkey";
787 $rs = $conn->Execute($sql);
788 ADODB_Session
::_dumprs($rs);
794 if (ADODB_Session::Lock()) {
795 $conn->CommitTrans();
797 return $rs ?
true : false;
802 static function destroy($key) {
803 $conn = ADODB_Session
::_conn();
804 $table = ADODB_Session
::table();
805 $expire_notify = ADODB_Session
::expireNotify();
810 $debug = ADODB_Session
::debug();
811 if ($debug) $conn->debug
= 1;
814 $qkey = $conn->quote($key);
815 $binary = $conn->dataProvider
=== 'mysql' ?
'/*! BINARY */' : '';
817 if ($expire_notify) {
818 reset($expire_notify);
819 $fn = next($expire_notify);
820 $savem = $conn->SetFetchMode(ADODB_FETCH_NUM
);
821 $sql = "SELECT expireref, sesskey FROM $table WHERE $binary sesskey = $qkey";
822 $rs = $conn->Execute($sql);
823 ADODB_Session
::_dumprs($rs);
824 $conn->SetFetchMode($savem);
829 $ref = $rs->fields
[0];
830 $key = $rs->fields
[1];
838 $sql = "DELETE FROM $table WHERE $binary sesskey = $qkey";
839 $rs = $conn->Execute($sql);
844 return $rs ?
true : false;
849 static function gc($maxlifetime)
851 $conn = ADODB_Session
::_conn();
852 $debug = ADODB_Session
::debug();
853 $expire_notify = ADODB_Session
::expireNotify();
854 $optimize = ADODB_Session
::optimize();
855 $table = ADODB_Session
::table();
862 $debug = ADODB_Session
::debug();
872 $time = $conn->OffsetDate(-$maxlifetime/24/3600,$conn->sysTimeStamp
);
873 $binary = $conn->dataProvider
=== 'mysql' ?
'/*! BINARY */' : '';
875 if ($expire_notify) {
876 reset($expire_notify);
877 $fn = next($expire_notify);
882 $savem = $conn->SetFetchMode(ADODB_FETCH_NUM
);
883 $sql = "SELECT expireref, sesskey FROM $table WHERE expiry < $time ORDER BY 2"; # add order by to prevent deadlock
884 $rs = $conn->SelectLimit($sql,1000);
885 if ($debug) ADODB_Session
::_dumprs($rs);
886 $conn->SetFetchMode($savem);
888 $tr = $conn->hasTransactions
;
889 if ($tr) $conn->BeginTrans();
893 $ref = $rs->fields
[0];
894 $key = $rs->fields
[1];
895 if ($fn) $fn($ref, $key);
896 $del = $conn->Execute("DELETE FROM $table WHERE sesskey=".$conn->Param('0'),array($key));
899 if ($tr && $ccnt %
$COMMITNUM == 0) {
900 if ($debug) echo "Commit<br>\n";
901 $conn->CommitTrans();
907 if ($tr) $conn->CommitTrans();
911 // suggested by Cameron, "GaM3R" <gamr@outworld.cx>
913 $driver = ADODB_Session
::driver();
915 if (preg_match('/mysql/i', $driver)) {
916 $sql = "OPTIMIZE TABLE $table";
918 if (preg_match('/postgres/i', $driver)) {
919 $sql = "VACUUM $table";
922 $conn->Execute($sql);
931 ADODB_Session
::_init();
932 if (empty($ADODB_SESSION_READONLY))
933 register_shutdown_function('session_write_close');
935 // for backwards compatability only
936 function adodb_sess_open($save_path, $session_name, $persist = true) {
937 return ADODB_Session
::open($save_path, $session_name, $persist);
940 // for backwards compatability only
941 function adodb_sess_gc($t)
943 return ADODB_Session
::gc($t);