<?php

namespace {
    /**
     * Zend Framework
     *
     * LICENSE
     *
     * This source file is subject to the new BSD license that is bundled
     * with this package in the file LICENSE.txt.
     * It is also available through the world-wide-web at this URL:
     * http://framework.zend.com/license/new-bsd
     * If you did not receive a copy of the license and are unable to
     * obtain it through the world-wide-web, please send an email
     * to license@zend.com so we can send you a copy immediately.
     *
     * @category   Zend
     * @package    Zend_Session
     * @copyright  Copyright (c) 2005-2011 Zend Technologies USA Inc. (http://www.zend.com)
     * @license    http://framework.zend.com/license/new-bsd     New BSD License
     * @version    $Id: Namespace.php 23775 2011-03-01 17:25:24Z ralph $
     * @since      Preview Release 0.2
     */
    /**
     * @see Zend_Session
     */
    // require_once 'Zend/Session.php';
    /**
     * @see Zend_Session_Abstract
     */
    // require_once 'Zend/Session/Abstract.php';
    /**
     * Zend_Session_Namespace
     *
     * @category   Zend
     * @package    Zend_Session
     * @copyright  Copyright (c) 2005-2011 Zend Technologies USA Inc. (http://www.zend.com)
     * @license    http://framework.zend.com/license/new-bsd     New BSD License
     */
    class Zend_Session_Namespace extends \Zend_Session_Abstract implements \IteratorAggregate
    {
        /**
         * used as option to constructor to prevent additional instances to the same namespace
         */
        const SINGLE_INSTANCE = \true;
        /**
         * Namespace - which namespace this instance of zend-session is saving-to/getting-from
         *
         * @var string
         */
        protected $_namespace = "Default";
        /**
         * Namespace locking mechanism
         *
         * @var array
         */
        protected static $_namespaceLocks = array();
        /**
         * Single instance namespace array to ensure data security.
         *
         * @var array
         */
        protected static $_singleInstances = array();
        /**
         * resetSingleInstance()
         *
         * @param string $namespaceName
         * @return null
         */
        public static function resetSingleInstance($namespaceName = null)
        {
            if ($namespaceName != null) {
                if (\array_key_exists($namespaceName, self::$_singleInstances)) {
                    unset(self::$_singleInstances[$namespaceName]);
                }
                return;
            }
            self::$_singleInstances = array();
            return;
        }
        /**
         * __construct() - Returns an instance object bound to a particular, isolated section
         * of the session, identified by $namespace name (defaulting to 'Default').
         * The optional argument $singleInstance will prevent construction of additional
         * instance objects acting as accessors to this $namespace.
         *
         * @param string $namespace       - programmatic name of the requested namespace
         * @param bool $singleInstance    - prevent creation of additional accessor instance objects for this namespace
         * @return void
         */
        public function __construct($namespace = 'Default', $singleInstance = \false)
        {
            if ($namespace === '') {
                /**
                 * @see Zend_Session_Exception
                 */
                // require_once 'Zend/Session/Exception.php';
                throw new \Zend_Session_Exception('Session namespace must be a non-empty string.');
            }
            if ($namespace[0] == "_") {
                /**
                 * @see Zend_Session_Exception
                 */
                // require_once 'Zend/Session/Exception.php';
                throw new \Zend_Session_Exception('Session namespace must not start with an underscore.');
            }
            if (\preg_match('#(^[0-9])#i', $namespace[0])) {
                /**
                 * @see Zend_Session_Exception
                 */
                // require_once 'Zend/Session/Exception.php';
                throw new \Zend_Session_Exception('Session namespace must not start with a number.');
            }
            if (isset(self::$_singleInstances[$namespace])) {
                /**
                 * @see Zend_Session_Exception
                 */
                // require_once 'Zend/Session/Exception.php';
                throw new \Zend_Session_Exception("A session namespace object already exists for this namespace ('{$namespace}'), and no additional accessors (session namespace objects) for this namespace are permitted.");
            }
            if ($singleInstance === \true) {
                self::$_singleInstances[$namespace] = \true;
            }
            $this->_namespace = $namespace;
            // Process metadata specific only to this namespace.
            \Zend_Session::start(\true);
            // attempt auto-start (throws exception if strict option set)
            if (self::$_readable === \false) {
                /**
                 * @see Zend_Session_Exception
                 */
                // require_once 'Zend/Session/Exception.php';
                throw new \Zend_Session_Exception(self::_THROW_NOT_READABLE_MSG);
            }
            if (!isset($_SESSION['__ZF'])) {
                return;
                // no further processing needed
            }
            // do not allow write access to namespaces, after stop() or writeClose()
            if (parent::$_writable === \true) {
                if (isset($_SESSION['__ZF'][$namespace])) {
                    // Expire Namespace by Namespace Hop (ENNH)
                    if (isset($_SESSION['__ZF'][$namespace]['ENNH'])) {
                        $_SESSION['__ZF'][$namespace]['ENNH']--;
                        if ($_SESSION['__ZF'][$namespace]['ENNH'] === 0) {
                            if (isset($_SESSION[$namespace])) {
                                self::$_expiringData[$namespace] = $_SESSION[$namespace];
                                unset($_SESSION[$namespace]);
                            }
                            unset($_SESSION['__ZF'][$namespace]);
                        }
                    }
                    // Expire Namespace Variables by Namespace Hop (ENVNH)
                    if (isset($_SESSION['__ZF'][$namespace]['ENVNH'])) {
                        foreach ($_SESSION['__ZF'][$namespace]['ENVNH'] as $variable => $hops) {
                            $_SESSION['__ZF'][$namespace]['ENVNH'][$variable]--;
                            if ($_SESSION['__ZF'][$namespace]['ENVNH'][$variable] === 0) {
                                if (isset($_SESSION[$namespace][$variable])) {
                                    self::$_expiringData[$namespace][$variable] = $_SESSION[$namespace][$variable];
                                    unset($_SESSION[$namespace][$variable]);
                                }
                                unset($_SESSION['__ZF'][$namespace]['ENVNH'][$variable]);
                            }
                        }
                        if (empty($_SESSION['__ZF'][$namespace]['ENVNH'])) {
                            unset($_SESSION['__ZF'][$namespace]['ENVNH']);
                        }
                    }
                }
                if (empty($_SESSION['__ZF'][$namespace])) {
                    unset($_SESSION['__ZF'][$namespace]);
                }
                if (empty($_SESSION['__ZF'])) {
                    unset($_SESSION['__ZF']);
                }
            }
        }
        /**
         * getIterator() - return an iteratable object for use in foreach and the like,
         * this completes the IteratorAggregate interface
         *
         * @return ArrayObject - iteratable container of the namespace contents
         */
        public function getIterator() : \ArrayObject
        {
            return new \ArrayObject(parent::_namespaceGetAll($this->_namespace));
        }
        /**
         * lock() - mark a session/namespace as readonly
         *
         * @return void
         */
        public function lock()
        {
            self::$_namespaceLocks[$this->_namespace] = \true;
        }
        /**
         * unlock() - unmark a session/namespace to enable read & write
         *
         * @return void
         */
        public function unlock()
        {
            unset(self::$_namespaceLocks[$this->_namespace]);
        }
        /**
         * unlockAll() - unmark all session/namespaces to enable read & write
         *
         * @return void
         */
        public static function unlockAll()
        {
            self::$_namespaceLocks = array();
        }
        /**
         * isLocked() - return lock status, true if, and only if, read-only
         *
         * @return bool
         */
        public function isLocked()
        {
            return isset(self::$_namespaceLocks[$this->_namespace]);
        }
        /**
         * unsetAll() - unset all variables in this namespace
         *
         * @return true
         */
        public function unsetAll()
        {
            return parent::_namespaceUnset($this->_namespace);
        }
        /**
         * __get() - method to get a variable in this object's current namespace
         *
         * @param string $name - programmatic name of a key, in a <key,value> pair in the current namespace
         * @return mixed
         */
        public function &__get($name)
        {
            if ($name === '') {
                /**
                 * @see Zend_Session_Exception
                 */
                // require_once 'Zend/Session/Exception.php';
                throw new \Zend_Session_Exception("The '{$name}' key must be a non-empty string");
            }
            return parent::_namespaceGet($this->_namespace, $name);
        }
        /**
         * __set() - method to set a variable/value in this object's namespace
         *
         * @param string $name - programmatic name of a key, in a <key,value> pair in the current namespace
         * @param mixed $value - value in the <key,value> pair to assign to the $name key
         * @throws Zend_Session_Exception
         * @return true
         */
        public function __set($name, $value)
        {
            if (isset(self::$_namespaceLocks[$this->_namespace])) {
                /**
                 * @see Zend_Session_Exception
                 */
                // require_once 'Zend/Session/Exception.php';
                throw new \Zend_Session_Exception('This session/namespace has been marked as read-only.');
            }
            if ($name === '') {
                /**
                 * @see Zend_Session_Exception
                 */
                // require_once 'Zend/Session/Exception.php';
                throw new \Zend_Session_Exception("The '{$name}' key must be a non-empty string");
            }
            if (parent::$_writable === \false) {
                /**
                 * @see Zend_Session_Exception
                 */
                // require_once 'Zend/Session/Exception.php';
                throw new \Zend_Session_Exception(parent::_THROW_NOT_WRITABLE_MSG);
            }
            $name = (string) $name;
            $_SESSION[$this->_namespace][$name] = $value;
        }
        /**
         * apply() - enables applying user-selected function, such as array_merge() to the namespace
         * Parameters following the $callback argument are passed to the callback function.
         * Caveat: ignores members expiring now.
         *
         * Example:
         *   $namespace->apply('array_merge', array('tree' => 'apple', 'fruit' => 'peach'), array('flower' => 'rose'));
         *   $namespace->apply('count');
         *
         * @param string|array $callback - callback function
         */
        public function apply($callback)
        {
            $arg_list = \func_get_args();
            $arg_list[0] = $_SESSION[$this->_namespace];
            return \call_user_func_array($callback, $arg_list);
        }
        /**
         * applySet() - enables applying user-selected function, and sets entire namespace to the result
         * Result of $callback must be an array.
         * Parameters following the $callback argument are passed to the callback function.
         * Caveat: ignores members expiring now.
         *
         * Example:
         *   $namespace->applySet('array_merge', array('tree' => 'apple', 'fruit' => 'peach'), array('flower' => 'rose'));
         *
         * @param string|array $callback - callback function
         */
        public function applySet($callback)
        {
            $arg_list = \func_get_args();
            $arg_list[0] = $_SESSION[$this->_namespace];
            $result = \call_user_func_array($callback, $arg_list);
            if (!\is_array($result)) {
                /**
                 * @see Zend_Session_Exception
                 */
                // require_once 'Zend/Session/Exception.php';
                throw new \Zend_Session_Exception('Result must be an array. Got: ' . \gettype($result));
            }
            $_SESSION[$this->_namespace] = $result;
            return $result;
        }
        /**
         * __isset() - determine if a variable in this object's namespace is set
         *
         * @param string $name - programmatic name of a key, in a <key,value> pair in the current namespace
         * @return bool
         */
        public function __isset($name)
        {
            if ($name === '') {
                /**
                 * @see Zend_Session_Exception
                 */
                // require_once 'Zend/Session/Exception.php';
                throw new \Zend_Session_Exception("The '{$name}' key must be a non-empty string");
            }
            return parent::_namespaceIsset($this->_namespace, $name);
        }
        /**
         * __unset() - unset a variable in this object's namespace.
         *
         * @param string $name - programmatic name of a key, in a <key,value> pair in the current namespace
         * @return true
         */
        public function __unset($name)
        {
            if ($name === '') {
                /**
                 * @see Zend_Session_Exception
                 */
                // require_once 'Zend/Session/Exception.php';
                throw new \Zend_Session_Exception("The '{$name}' key must be a non-empty string");
            }
            return parent::_namespaceUnset($this->_namespace, $name);
        }
        /**
         * setExpirationSeconds() - expire the namespace, or specific variables after a specified
         * number of seconds
         *
         * @param int $seconds     - expires in this many seconds
         * @param mixed $variables - OPTIONAL list of variables to expire (defaults to all)
         * @throws Zend_Session_Exception
         * @return void
         */
        public function setExpirationSeconds($seconds, $variables = null)
        {
            if (parent::$_writable === \false) {
                /**
                 * @see Zend_Session_Exception
                 */
                // require_once 'Zend/Session/Exception.php';
                throw new \Zend_Session_Exception(parent::_THROW_NOT_WRITABLE_MSG);
            }
            if ($seconds <= 0) {
                /**
                 * @see Zend_Session_Exception
                 */
                // require_once 'Zend/Session/Exception.php';
                throw new \Zend_Session_Exception('Seconds must be positive.');
            }
            if ($variables === null) {
                // apply expiration to entire namespace
                $_SESSION['__ZF'][$this->_namespace]['ENT'] = \time() + $seconds;
            } else {
                if (\is_string($variables)) {
                    $variables = array($variables);
                }
                foreach ($variables as $variable) {
                    if (!empty($variable)) {
                        $_SESSION['__ZF'][$this->_namespace]['ENVT'][$variable] = \time() + $seconds;
                    }
                }
            }
        }
        /**
         * setExpirationHops() - expire the namespace, or specific variables after a specified
         * number of page hops
         *
         * @param int $hops        - how many "hops" (number of subsequent requests) before expiring
         * @param mixed $variables - OPTIONAL list of variables to expire (defaults to all)
         * @param boolean $hopCountOnUsageOnly - OPTIONAL if set, only count a hop/request if this namespace is used
         * @throws Zend_Session_Exception
         * @return void
         */
        public function setExpirationHops($hops, $variables = null, $hopCountOnUsageOnly = \false)
        {
            if (parent::$_writable === \false) {
                /**
                 * @see Zend_Session_Exception
                 */
                // require_once 'Zend/Session/Exception.php';
                throw new \Zend_Session_Exception(parent::_THROW_NOT_WRITABLE_MSG);
            }
            if ($hops <= 0) {
                /**
                 * @see Zend_Session_Exception
                 */
                // require_once 'Zend/Session/Exception.php';
                throw new \Zend_Session_Exception('Hops must be positive number.');
            }
            if ($variables === null) {
                // apply expiration to entire namespace
                if ($hopCountOnUsageOnly === \false) {
                    $_SESSION['__ZF'][$this->_namespace]['ENGH'] = $hops;
                } else {
                    $_SESSION['__ZF'][$this->_namespace]['ENNH'] = $hops;
                }
            } else {
                if (\is_string($variables)) {
                    $variables = array($variables);
                }
                foreach ($variables as $variable) {
                    if (!empty($variable)) {
                        if ($hopCountOnUsageOnly === \false) {
                            $_SESSION['__ZF'][$this->_namespace]['ENVGH'][$variable] = $hops;
                        } else {
                            $_SESSION['__ZF'][$this->_namespace]['ENVNH'][$variable] = $hops;
                        }
                    }
                }
            }
        }
        /**
         * Returns the namespace name
         *
         * @return string
         */
        public function getNamespace()
        {
            return $this->_namespace;
        }
    }
}
