Zend Framework1-Zend_Session

在Zend Framework中，Zend_Session_Namespace实例提供了操作会话数据主要的API。

命名空间常用于隔离所有的会话数据，尽管也为所有会话数据只需要一个命名空间的情况提供了一个默认的命名空间。

Zend_Session利用了PHP内置的会话模块（ext/session），以及它特有的$_SESSION全局数组做为会话状态数据的存储机制。

虽然$_SESSION在PHP的全局命名空间内仍然可以访问，但是开发者不应该直接访问它，这样Zend_Session 和 Zend_Session_Namespace可以提供一组最可靠、安全的处理会话相关的功能。

每个Zend_Session_Namespace的实例对应于$_SESSION全局数组的一个条目，在那里命名空间被用作键。

<?php
require_once 'Zend/Session/Namespace.php';

$myNamespace = new Zend_Session_Namespace('myNamespace');

// $myNamespace corresponds to $_SESSION['myNamespace']
        

<?php
require_once 'Zend/Session/Namespace.php';

$defaultNamespace = new Zend_Session_Namespace('Default');

if (isset($defaultNamespace->numberOfPageRequests)) {
    $defaultNamespace->numberOfPageRequests++; // 每次页面加载，这个将递增
} else {
    $defaultNamespace->numberOfPageRequests = 1; // 第一次
}

echo "Page requests this session: ", $defaultNamespace->numberOfPageRequests;
            

<?php
require_once 'Zend/Session/Namespace.php';

// in the Zend_Auth component
$authNamespace = new Zend_Session_Namespace('Zend_Auth');
$authNamespace->user = "myusername";

// in a web services component
$webServiceNamespace = new Zend_Session_Namespace('Some_Web_Service');
$webServiceNamespace->user = "mywebusername";
            

<?php
$_SESSION['Zend_Auth']['user'] = "myusername";
$_SESSION['Some_Web_Service']['user'] = "mywebusername";
            

<?php
require_once 'Zend/Session/Namespace.php';

$aNamespace = new Zend_Session_Namespace('some_namespace_with_data_present');

foreach ($aNamespace as $index => $value) {
    echo "aNamespace->$index = '$value';\n";
}
            

<?php
require_once 'Zend/Session/Namespace.php';

$namespace = new Zend_Session_Namespace(); // 缺省的命名空间

$namespace->foo = 100;

echo "\$namespace->foo = $namespace->foo\n";

if (!isset($namespace->bar)) {
    echo "\$namespace->bar not set\n";
}

unset($namespace->foo);
            

如果你希望所有的请求都有个由Zend_Seesion管理的会话，那么请在程序的引导文件中开启它：

<?php
require_once 'Zend/Session.php';

Zend_Session::start();
            

在程序的引导文件中开启会话，可以避免引发会话开启之前已经有HTTP头发向用户浏览器的异常，那样可能会破坏web页面的美观。许多高级的特性需要先执行Zend_Session::start()（更多高级的特性之后会展开）。

使用Zend_Session组件，有4种开启会话的方法，其中2种是错误的。

1. 错误的：不要开启PHP的session.auto_startsetting。如果你使用mode_php(或等同）并在php.ini中已经开启了该选项，而你又没有权限去关闭该选项，你可以在.htaccess文件（这个文件通常在HTML文档根目录下）中增加下面这一句：

   php_value session.auto_start 0
   

2. 错误的：不要直接使用PHP的 session_start()函数。如果你直接使用session_start()，之后再使用Zend_Session_Namespace，那么Zend_Session::start()会抛出（"会话已经开始"）的异常。如果你在使用Zend_Session_Namespace或使用Zend_Session::start()后调用session_start()，那么会产生一个E_NOTICE级别的错误，且该调用将会被忽略。

3. 正确的：使用Zend_Session::start()开启会话。如果你想让每个页面请求都开启会话，那么应该在ZF应用程序的引导文件（index.php）中尽早的调用这个函数。开启会话有些额外的开销，如果只有部分页面请求需要开启会话，那么就：

   • 在引导文件中，使用Zend_Session::setOptions()无条件地设置strict选项为true。

   • 在任何Zend_Session_Namespace()对象初始化之前对需要使用会话的请求只调用Zend_Session::start()。

   • 象往常一样，在需要会话的地方，使用"new Zend_Session_Namespace()"，但必须确认先前已经调用过Zend_Session::start()了。

   strict 选项防止 new Zend_Session_Namespace() 自动调用 Zend_Session::start()。 这样，这个选项有利于应用程序的开发者强制执行一个设计原则以避免在某些页面请求中使用会话， 因为在调用 Zend_Session::start() 之前，实例化 Zend_Session_Namespace 时，会抛出一个异常。开发者需小心地考虑使用 Zend_Session::setOptions() 所引起的冲突，由于它们对应于基本的ext/session这些具有全局作用选项。

4. 正确的：只要有需要使用会话的地方，就初始化new Zend_Session_Namespace()，并且基本的PHP会话将自动开启。这个极端简单的用法能在大多数的情形下很好地工作。然而，如果你使用地是默认的基于cookie的会话（强烈推荐使用这种方式），你必须确保在第一次调用new Zend_Session_Namespace()在任何PHP发向向客户端输出（例如，HTTP headers）之前。

会话的命名空间可以加锁，以防止意外的变更该命名空间下的会话变量值。

使用lock()方法使某命名空间下会话变量为只读，unlock()方法使一个只读的名空间为可读写，isLocked()方法测试某命名空间是否已经被加锁。

加锁是短暂的，且只在此页面请求内有效，不会持续到下一个页面请求。给命名空间加锁不会影响到存储在该命名空间下对象的setter方法，但是阻止了命名空间的setter方法的移除或替换对象。

也就是说，虽给Zend_Session_Namespace的实例加了锁，但还是不能阻止它处同样引用了命名空间下数据的对它的变更。

<?php
require_once 'Zend/Session/Namespace.php';

$userProfileNamespace = new Zend_Session_Namespace('userProfileNamespace');

// 标记会话设置为只读锁定
$userProfileNamespace->lock();

// 解锁只读锁定
if ($userProfileNamespace->isLocked()) {
$userProfileNamespace->unLock();
}       

对于命名空间和在命名空间中的独立键，它们的寿命都是有限的。

在授权后，普通用例包括在请求之间传递临时信息，和通过除去访问潜在的敏感信息来降低一定的安全风险的暴露时有发生。

过期可以基于消逝的秒数或者跳步(hop)的个数，对每次初始化命名空间的成功请求，跳步至少发生一次。

<?php
require_once 'Zend/Session/Namespace.php';

$s = new Zend_Session_Namespace('expireAll');
$s->a = 'apple';
$s->p = 'pear';
$s->o = 'orange';

$s->setExpirationSeconds(5, 'a'); // expire only the key "a" in 5 seconds

// 5 次访问后，会话过期
$s->setExpirationHops(5);

$s->setExpirationSeconds(60);
// 命名空间 "expireAll" 将在第一次访问后 60 秒，或者访问 5 次后过期。
            

在处理在当前请求中会话数据过期，需要小心来提取它们（会话数据）。尽管数据通过引用返回，修改数据将不使过期数据持续传递当前请求。

为了“重置”过期时间，把数据放到临时变量，用命名空间来unset它们，然后再设置合适的键。

命名空间可以被用来分离控制器对会话的访问，以免被污染。例如， 一个认证控制器可以为会议安全请求保持它的会话状态数据与其他控制器分离。

<?php
// ...
// in the question view controller
require_once 'Zend/Session/Namespace.php';
$testSpace = new Zend_Session_Namespace('testSpace');
$testSpace->setExpirationSeconds(300, 'accept_answer'); // expire only this variable
$testSpace->accept_answer = true;
//...
            

<?php
// ...
// in the answer processing controller
require_once 'Zend/Session/Namespace.php';
$testSpace = new Zend_Session_Namespace('testSpace');
if ($testSpace->accept_answer === true) {
    // within time
}
else {
    // not within time
}
// ...
            

尽管session locking提供了很好的保护来防止意外的命名空间的会话数据的使用，Zend_Session_Namespace 也有能力防止给一个单个的命名空间创建多个实例。

为开启这个动作，当创建Zend_Session_Namespace的最后允许的实例，传递true给第二个构造函数参数。任何后来的初始化同一个命名空间的企图都会导致一个异常的抛出。

<?php
require_once 'Zend/Session/Namespace.php';

// create an instance of a namespace
$authSpaceAccessor1 = new Zend_Session_Namespace('Zend_Auth');

// create another instance of the same namespace, but disallow any new instances
$authSpaceAccessor2 = new Zend_Session_Namespace('Zend_Auth', true);

// making a reference is still possible
$authSpaceAccessor3 = $authSpaceAccessor2;

$authSpaceAccessor1->foo = 'bar';

assert($authSpaceAccessor2->foo, 'bar');

try {
    $aNamespaceObject = new Zend_Session_Namespace('Zend_Auth');
} catch (Zend_Session_Exception $e) {
    echo "Cannot instantiate this namespace since \$authSpaceAccessor2 was created\n";
}
            

上面构造函数的第二个参数告诉Zend_Session_Namespace任何之后带有"Zend_Auth"实例的命名空间都是不允许的。

企图创建这样的实例导致构造函数抛出一个异常。

如果在相同的请求期间稍后需要访问会话的命名空间，开发者因此有责任在其它地方给一个实例对象（在上面的例子中$authSpaceAccessor1， $authSpaceAccessor2 或者$authSpaceAccessor3）存储一个引用。

例如，开发者可以存储引用到一个静态变量，添加一个引用给一个registry （参见Zend_Registry），或者使它对其它需要访问会话命名空间的方法可用。