1: <?php
  2: /**
  3:  * LICENSE (BSD)
  4:  *
  5:  * Copyright (c) 2012, Gerd Christian Kunze
  6:  * All rights reserved.
  7:  *
  8:  * Redistribution and use in source and binary forms, with or without
  9:  * modification, are permitted provided that the following conditions are
 10:  * met:
 11:  *
 12:  *  * Redistributions of source code must retain the above copyright
 13:  *    notice, this list of conditions and the following disclaimer.
 14:  *
 15:  *  * Redistributions in binary form must reproduce the above copyright
 16:  *    notice, this list of conditions and the following disclaimer in the
 17:  *    documentation and/or other materials provided with the distribution.
 18:  *
 19:  *  * Neither the name of Gerd Christian Kunze nor the names of the
 20:  *    contributors may be used to endorse or promote products derived from
 21:  *    this software without specific prior written permission.
 22:  *
 23:  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
 24:  * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
 25:  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 26:  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 27:  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 28:  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 29:  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 30:  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 31:  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 32:  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 33:  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 34:  *
 35:  * Session
 36:  * 30.08.2012 16:56
 37:  */
 38: namespace MOC\Core;
 39: use MOC\Api;
 40: use MOC\Generic\Device\Core;
 41: 
 42: /**
 43:  *
 44:  */
 45: class Session implements Core {
 46:     /** @var Session $Singleton */
 47:     private static $Singleton = null;
 48: 
 49:     /**
 50:      * Get Singleton/Instance
 51:      *
 52:      * @static
 53:      * @return Session
 54:      */
 55:     public static function InterfaceInstance() {
 56:         if( self::$Singleton === null ) {
 57:             self::$Singleton = new Session();
 58:         } return self::$Singleton;
 59:     }
 60: 
 61:     /**
 62:      * Get Changelog
 63:      *
 64:      * @static
 65:      * @return \MOC\Core\Changelog
 66:      */
 67:     public static function InterfaceChangelog() {
 68:         return Api::Core()->Changelog()->Create( __CLASS__ );
 69:     }
 70: 
 71:     /**
 72:      * Get Dependencies
 73:      *
 74:      * @static
 75:      * @return \MOC\Core\Depending
 76:      */
 77:     public static function InterfaceDepending() {
 78:         return Api::Core()->Depending();
 79:     }
 80: 
 81:     /** @var string $Identifier */
 82:     private $Identifier = __CLASS__;
 83:     /**
 84:      * @static
 85:      * @return string Handler ID
 86:      */
 87:     public function Start() {
 88:         if( !strlen( session_id() ) > 0 ) {
 89:             session_start();
 90:             if( !isset( $_SESSION[$this->Identifier()] ) ) {
 91:                 $_SESSION[$this->Identifier()] = array();
 92:             }
 93:         } return session_id();
 94:     }
 95:     /**
 96:      * @static
 97:      * @return string Handler ID
 98:      */
 99:     public function Id() {
100:         $this->Start();
101:         return session_id();
102:     }
103:     /**
104:      * @static
105:      * @param string $Index
106:      * @param mixed $Value
107:      * @return mixed
108:      */
109:     public function Write( $Index, $Value ) {
110:         $this->Start();
111:         return $_SESSION[$this->Identifier()][$Index] = $Value;
112:     }
113:     /**
114:      * @static
115:      * @param null $Index
116:      * @return null|array|mixed
117:      */
118:     public function Read( $Index = null ) {
119:         $this->Start();
120:         if( $Index !== null ) {
121:             if( isset( $_SESSION[$this->Identifier()][$Index] ) ) {
122:                 return $_SESSION[$this->Identifier()][$Index];
123:             } else {
124:                 return null;
125:             }
126:         } return $_SESSION[$this->Identifier()];
127:     }
128:     /**
129:      * @static
130:      * @param null $Identifier
131:      * @return string
132:      */
133:     private function Identifier( $Identifier = null ) {
134:         if( $Identifier !== null ) {
135:             $this->Identifier = $Identifier;
136:         } return $this->Identifier;
137:     }
138: }
139: