<h2>File Contents: /home/planet5/public_html/4xpips.net/secure/library/Zend/Session/copy_of_copy_of_Namespace.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/4xpips.net/secure/library/Zend/Session/copy_of_copy_of_Namespace.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * 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-2012 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 * @version    $Id: Namespace.php 24594 2012-01-05 21:27:01Z matthew $
 * @since      Preview Release 0.2
 */


/**
 * @see Zend_Session
 */
//--//require_once &#039;Zend/Session.php&#039;;


/**
 * @see Zend_Session_Abstract
 */
//--//require_once &#039;Zend/Session/Abstract.php&#039;;


/**
 * Zend_Session_Namespace
 *
 * @category   Zend
 * @package    Zend_Session
 * @copyright  Copyright (c) 2005-2012 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 = &quot;Default&quot;;

    /**
     * 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 &#039;Default&#039;).
     * 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 = &#039;Default&#039;, $singleInstance = false)
    {
        if ($namespace === &#039;&#039;) {
            /**
             * @see Zend_Session_Exception
             */
            //--//require_once &#039;Zend/Session/Exception.php&#039;;
            throw new Zend_Session_Exception(&#039;Session namespace must be a non-empty string.&#039;);
        }

        if ($namespace[0] == &quot;_&quot;) {
            /**
             * @see Zend_Session_Exception
             */
            //--//require_once &#039;Zend/Session/Exception.php&#039;;
            throw new Zend_Session_Exception(&#039;Session namespace must not start with an underscore.&#039;);
        }

        if (preg_match(&#039;#(^[0-9])#i&#039;, $namespace[0])) {
            /**
             * @see Zend_Session_Exception
             */
            //--//require_once &#039;Zend/Session/Exception.php&#039;;
            throw new Zend_Session_Exception(&#039;Session namespace must not start with a number.&#039;);
        }

        if (isset(self::$_singleInstances[$namespace])) {
            /**
             * @see Zend_Session_Exception
             */
            //--//require_once &#039;Zend/Session/Exception.php&#039;;
            throw new Zend_Session_Exception(&quot;A session namespace object already exists for this namespace (&#039;$namespace&#039;), and no additional accessors (session namespace objects) for this namespace are permitted.&quot;);
        }

        if ($singleInstance === true) {
            self::$_singleInstances[$namespace] = true;
        }

        $this-&gt;_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 &#039;Zend/Session/Exception.php&#039;;
            throw new Zend_Session_Exception(self::_THROW_NOT_READABLE_MSG);
        }

        if (!isset($_SESSION[&#039;__ZF&#039;])) {
            return; // no further processing needed
        }

        // do not allow write access to namespaces, after stop() or writeClose()
        if (parent::$_writable === true) {
            if (isset($_SESSION[&#039;__ZF&#039;][$namespace])) {

                // Expire Namespace by Namespace Hop (ENNH)
                if (isset($_SESSION[&#039;__ZF&#039;][$namespace][&#039;ENNH&#039;])) {
                    $_SESSION[&#039;__ZF&#039;][$namespace][&#039;ENNH&#039;]--;

                    if ($_SESSION[&#039;__ZF&#039;][$namespace][&#039;ENNH&#039;] === 0) {
                        if (isset($_SESSION[$namespace])) {
                            self::$_expiringData[$namespace] = $_SESSION[$namespace];
                            unset($_SESSION[$namespace]);
                        }
                        unset($_SESSION[&#039;__ZF&#039;][$namespace]);
                    }
                }

                // Expire Namespace Variables by Namespace Hop (ENVNH)
                if (isset($_SESSION[&#039;__ZF&#039;][$namespace][&#039;ENVNH&#039;])) {
                    foreach ($_SESSION[&#039;__ZF&#039;][$namespace][&#039;ENVNH&#039;] as $variable =&gt; $hops) {
                        $_SESSION[&#039;__ZF&#039;][$namespace][&#039;ENVNH&#039;][$variable]--;

                        if ($_SESSION[&#039;__ZF&#039;][$namespace][&#039;ENVNH&#039;][$variable] === 0) {
                            if (isset($_SESSION[$namespace][$variable])) {
                                self::$_expiringData[$namespace][$variable] = $_SESSION[$namespace][$variable];
                                unset($_SESSION[$namespace][$variable]);
                            }
                            unset($_SESSION[&#039;__ZF&#039;][$namespace][&#039;ENVNH&#039;][$variable]);
                        }
                    }
                    if(empty($_SESSION[&#039;__ZF&#039;][$namespace][&#039;ENVNH&#039;])) {
                        unset($_SESSION[&#039;__ZF&#039;][$namespace][&#039;ENVNH&#039;]);
                    }
                }
            }

            if (empty($_SESSION[&#039;__ZF&#039;][$namespace])) {
                unset($_SESSION[&#039;__ZF&#039;][$namespace]);
            }

            if (empty($_SESSION[&#039;__ZF&#039;])) {
                unset($_SESSION[&#039;__ZF&#039;]);
            }
        }
    }


    /**
     * 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()
    {
        return new ArrayObject(parent::_namespaceGetAll($this-&gt;_namespace));
    }


    /**
     * lock() - mark a session/namespace as readonly
     *
     * @return void
     */
    public function lock()
    {
        self::$_namespaceLocks[$this-&gt;_namespace] = true;
    }


    /**
     * unlock() - unmark a session/namespace to enable read &amp; write
     *
     * @return void
     */
    public function unlock()
    {
        unset(self::$_namespaceLocks[$this-&gt;_namespace]);
    }


    /**
     * unlockAll() - unmark all session/namespaces to enable read &amp; 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-&gt;_namespace]);
    }


    /**
     * unsetAll() - unset all variables in this namespace
     *
     * @return true
     */
    public function unsetAll()
    {
        return parent::_namespaceUnset($this-&gt;_namespace);
    }


    /**
     * __get() - method to get a variable in this object&#039;s current namespace
     *
     * @param string $name - programmatic name of a key, in a &lt;key,value&gt; pair in the current namespace
     * @return mixed
     */
    public function &amp; __get($name)
    {
        if ($name === &#039;&#039;) {
            /**
             * @see Zend_Session_Exception
             */
            //--//require_once &#039;Zend/Session/Exception.php&#039;;
            throw new Zend_Session_Exception(&quot;The &#039;$name&#039; key must be a non-empty string&quot;);
        }

        return parent::_namespaceGet($this-&gt;_namespace, $name);
    }


    /**
     * __set() - method to set a variable/value in this object&#039;s namespace
     *
     * @param string $name - programmatic name of a key, in a &lt;key,value&gt; pair in the current namespace
     * @param mixed $value - value in the &lt;key,value&gt; pair to assign to the $name key
     * @throws Zend_Session_Exception
     * @return true
     */
    public function __set($name, $value)
    {
        if (isset(self::$_namespaceLocks[$this-&gt;_namespace])) {
            /**
             * @see Zend_Session_Exception
             */
            //--//require_once &#039;Zend/Session/Exception.php&#039;;
            throw new Zend_Session_Exception(&#039;This session/namespace has been marked as read-only.&#039;);
        }

        if ($name === &#039;&#039;) {
            /**
             * @see Zend_Session_Exception
             */
            //--//require_once &#039;Zend/Session/Exception.php&#039;;
            throw new Zend_Session_Exception(&quot;The &#039;$name&#039; key must be a non-empty string&quot;);
        }

        if (parent::$_writable === false) {
            /**
             * @see Zend_Session_Exception
             */
            //--//require_once &#039;Zend/Session/Exception.php&#039;;
            throw new Zend_Session_Exception(parent::_THROW_NOT_WRITABLE_MSG);
        }

        $name = (string) $name;

        $_SESSION[$this-&gt;_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-&gt;apply(&#039;array_merge&#039;, array(&#039;tree&#039; =&gt; &#039;apple&#039;, &#039;fruit&#039; =&gt; &#039;peach&#039;), array(&#039;flower&#039; =&gt; &#039;rose&#039;));
     *   $namespace-&gt;apply(&#039;count&#039;);
     *
     * @param string|array $callback - callback function
     */
    public function apply($callback)
    {
        $arg_list = func_get_args();
        $arg_list[0] = $_SESSION[$this-&gt;_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-&gt;applySet(&#039;array_merge&#039;, array(&#039;tree&#039; =&gt; &#039;apple&#039;, &#039;fruit&#039; =&gt; &#039;peach&#039;), array(&#039;flower&#039; =&gt; &#039;rose&#039;));
     *
     * @param string|array $callback - callback function
     */
    public function applySet($callback)
    {
        $arg_list = func_get_args();
        $arg_list[0] = $_SESSION[$this-&gt;_namespace];
        $result = call_user_func_array($callback, $arg_list);
        if (!is_array($result)) {
            /**
             * @see Zend_Session_Exception
             */
            //--//require_once &#039;Zend/Session/Exception.php&#039;;
            throw new Zend_Session_Exception(&#039;Result must be an array. Got: &#039; . gettype($result));
        }
        $_SESSION[$this-&gt;_namespace] = $result;
        return $result;
    }


    /**
     * __isset() - determine if a variable in this object&#039;s namespace is set
     *
     * @param string $name - programmatic name of a key, in a &lt;key,value&gt; pair in the current namespace
     * @return bool
     */
    public function __isset($name)
    {
        if ($name === &#039;&#039;) {
            /**
             * @see Zend_Session_Exception
             */
            //--//require_once &#039;Zend/Session/Exception.php&#039;;
            throw new Zend_Session_Exception(&quot;The &#039;$name&#039; key must be a non-empty string&quot;);
        }

        return parent::_namespaceIsset($this-&gt;_namespace, $name);
    }


    /**
     * __unset() - unset a variable in this object&#039;s namespace.
     *
     * @param string $name - programmatic name of a key, in a &lt;key,value&gt; pair in the current namespace
     * @return true
     */
    public function __unset($name)
    {
        if ($name === &#039;&#039;) {
            /**
             * @see Zend_Session_Exception
             */
            //--//require_once &#039;Zend/Session/Exception.php&#039;;
            throw new Zend_Session_Exception(&quot;The &#039;$name&#039; key must be a non-empty string&quot;);
        }

        return parent::_namespaceUnset($this-&gt;_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 &#039;Zend/Session/Exception.php&#039;;
            throw new Zend_Session_Exception(parent::_THROW_NOT_WRITABLE_MSG);
        }

        if ($seconds &lt;= 0) {
            /**
             * @see Zend_Session_Exception
             */
            //--//require_once &#039;Zend/Session/Exception.php&#039;;
            throw new Zend_Session_Exception(&#039;Seconds must be positive.&#039;);
        }

        if ($variables === null) {

            // apply expiration to entire namespace
            $_SESSION[&#039;__ZF&#039;][$this-&gt;_namespace][&#039;ENT&#039;] = time() + $seconds;

        } else {

            if (is_string($variables)) {
                $variables = array($variables);
            }

            foreach ($variables as $variable) {
                if (!empty($variable)) {
                    $_SESSION[&#039;__ZF&#039;][$this-&gt;_namespace][&#039;ENVT&#039;][$variable] = time() + $seconds;
                }
            }
        }
    }


    /**
     * setExpirationHops() - expire the namespace, or specific variables after a specified
     * number of page hops
     *
     * @param int $hops        - how many &quot;hops&quot; (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 &#039;Zend/Session/Exception.php&#039;;
            throw new Zend_Session_Exception(parent::_THROW_NOT_WRITABLE_MSG);
        }

        if ($hops &lt;= 0) {
            /**
             * @see Zend_Session_Exception
             */
            //--//require_once &#039;Zend/Session/Exception.php&#039;;
            throw new Zend_Session_Exception(&#039;Hops must be positive number.&#039;);
        }

        if ($variables === null) {

            // apply expiration to entire namespace
            if ($hopCountOnUsageOnly === false) {
                $_SESSION[&#039;__ZF&#039;][$this-&gt;_namespace][&#039;ENGH&#039;] = $hops;
            } else {
                $_SESSION[&#039;__ZF&#039;][$this-&gt;_namespace][&#039;ENNH&#039;] = $hops;
            }

        } else {

            if (is_string($variables)) {
                $variables = array($variables);
            }

            foreach ($variables as $variable) {
                if (!empty($variable)) {
                    if ($hopCountOnUsageOnly === false) {
                        $_SESSION[&#039;__ZF&#039;][$this-&gt;_namespace][&#039;ENVGH&#039;][$variable] = $hops;
                    } else {
                        $_SESSION[&#039;__ZF&#039;][$this-&gt;_namespace][&#039;ENVNH&#039;][$variable] = $hops;
                    }
                }
            }
        }
    }

    /**
     * Returns the namespace name
     *
     * @return string
     */
    public function getNamespace()
    {
        return $this-&gt;_namespace;
    }
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2F4xpips.net%2Fsecure%2Flibrary%2FZend%2FSession'>⬅ Back to Directory</a>