第 32 章 Zend_Registry

要保存一项内容到注册表中，我们可以使用静态方法 set()。

Zend_Registry::set('index', $value);

           

$value可以是一个对象、数组或者标量。你可以再次使用set()来为注册表中已有的值设置一个新值。

index参数可以是一个标量，即字符串或整数，就像使用数组一样，类似于数组的索引/键名。

可以使用 get()方法来获取Registry中某项内容的值。

$value = Zend_Registry::get('index');

           

getInstance()返回静态registry对象。

registry对象是可迭代的（iterable）。

$registry = Zend_Registry::getInstance();

foreach ($registry as $index => $value) {
    echo "Registry index $index contains:\n";
    var_dump($value);
}

           

除了可以使用静态方法来访问Registry对象之外，你可以直接实例化它，就像使用普通的对象一样。

如果通过静态方法来访问registry对象的实例，它很方便进行静态存储，你可以在程序中的任何地方访问它。

如果使用传统的new 方法来创建registry的实例，则你可以使用数组一样的方式来初始化registry中的内容。

$registry = new Zend_Registry(array('index' => $value));

           

在创建这个对象实例之后，你可以使用数组对象方法来使用它，或者你可以把这个对象实例通过静态方法setInstance()设置为静态对象实例。

$registry = new Zend_Registry(array('index' => $value));

Zend_Registry::setInstance($registry);

           

如果静态的注册表对象已经被初始化过，则setInstance()方法会抛出一个Zend_Exception异常。

如果你要一次访问或设置多个值，你会发现使用数组方式是很方便的。

$registry = Zend_Registry::getInstance();

$registry['index'] = $value;

var_dump( $registry['index'] );

           

你会发现使用面向对象风格来访问registry对象也是方便的，对象中的属性名称作为索引。 要这样做，你需要使用ArrayObject::ARRAY_AS_PROPS选项来创建registry对象，并初始化静态实例。你要在静态的registry被第一次访问之前就完成这个工作。小心使用这个选项，因为某些版本的PHP在使用这个选项时会有bug。

//在你的bootstrap代码中：
$registry = new Zend_Registry(array(), ArrayObject::ARRAY_AS_PROPS)
Zend_Registry::setInstance($registry);
$registry->tree = 'apple';

.
.
.

//在程序的任何其它地方：
$registry = Zend_Registry::getInstance();

echo $registry->tree; // echo's "apple"

$registry->index = $value;

var_dump($registry->index);

           

可以使用静态方法isRegistered()来查询是否某个特定的索引已经设置了相应的值。

if (Zend_Registry::isRegistered($index)) {
    $value = Zend_Registry::get($index);
}

           

要确定一个数组对象中的某个特定索引的值是否设定，可以使用isset()函数，就像在普通的数组中那样使用。

$registry = Zend_Registry::getInstance();

// using array-access syntax
if (isset($registry['index'])) {
    var_dump( $registry['index'] );
}

// using object-access syntax, if enabled
if (isset($registry->index)) {
    var_dump( $registry->index );
}

           

静态registry对象是类Zend_Registry的一个实例。如果你想给它增加功能，你可以继承Zend_Registry类，然后指定使用这个类来访问对象注册表。你可以使用静态方法setClassName()来指定使用这个类。注意这个类一定要是Zend_Registry的子类。

Zend_Registry::setClassName('My_Registry');

Zend_Registry::set('index', $value);

           

如果你在registry已经被访问过后尝试设定该类名，则registry抛出一个异常。建议你在boostrap代码(即index.php)中设置该类名。

尽管这不是必需的，你可以使用_unsetInstance()方法来删除registry的静态实例。

	数据丢失的风险
	在使用_unsetInstance()的时候，静态注册表中的所有数据都会丢失并且无法恢复。

有时你可能需要_unsetInstance()这个方法。例如你想在已经初始化过registry对象之后，再使用setInstance()或 setClassName()，那么你可以使用_unsetInstance()先把静态实例删除了，然后才能使用那些方法。

Zend_Registry::set('index', $value);

Zend_Registry::_unsetInstance();

// 改变我们要使用的类
Zend_Registry::setClassName('My_Registry');

Zend_Registry::set('index', $value);