Главная / Zend Manual Core
Zend_Registry

Использование реестра

Реестр является контейнером для хранения объектов и значений в среде приложения. Посредством сохранения значения в реестре объект становится доступным всему приложению. Этот механизм является альтернативой использованию глобальных переменных.

Типовое использование реестра - использование статических методов класса Zend_Registry. Вы можете также обращаться к элементам, сохраненным в реестре, как к элементам массива, поскольку класс реестра наследует от ArrayObject.

Установка значений в реестре

Для того, чтобы сохранить значение в реестре, используйте статический метод set().

Example #1 Пример использования метода set()

  1. <?php
  2.  
  3. Zend_Registry::set('index', $value);
  4.  
  5. ?>

Сохраняемое значение может быть объектом, массивом или скаляром. Вы можете изменить значение, сохраненное под определенным индексом в реестре, устанавливая новое значение методом set().

Индекс может быть строкой или целочисленным значением, как в обычном массиве.

Получение значений из реестра

Для того, чтобы получить запись из реестра, используйте статический метод get().

Example #2 Пример использования метода get()

  1. <?php
  2.  
  3. $value = Zend_Registry::get('index');
  4.  
  5. ?>

Метод getInstance() возвращает статический объект реестра.

По объекту реестра можно производить итерацию.

Example #3 Пример итерации по реестру

  1. <?php
  2.  
  3. $registry = Zend_Registry::getInstance();
  4.  
  5. foreach ($registry as $index => $value) {
  6.     echo "Registry index $index contains:\n";
  7.     var_dump($value);
  8. }
  9.  
  10. ?>

Создание объекта реестра

Кроме доступа к статическому реестру через статические методы, вы можете также непосредственно создавать экземпляр реестра и использовать его как объект.

Экземпляр реестра, к которому вы обращаетесь через статические методы, просто является одним из таких экземпляров. Это сделано в целях удобства, т.к. оно сохраняется статически и вы можете обращаться к нему из любого места своего приложения.

Используйте традиционный конструктор new для создания экземпляра реестра. Это дает возможность иницизировать записи в реестре так же, как в массиве.

Example #4 Пример создания реестра

  1. <?php
  2.  
  3. $registry = new Zend_Registry(array('index' => $value));
  4.  
  5. ?>

После создания экземпляра вы можете использовать его с применением методов доступа ArrayObject, или установить его как статический экземпляр, используя статический метод setInstance().

Example #5 Пример инициализации статического реестра

  1. <?php
  2.  
  3. $registry = new Zend_Registry(array('index' => $value));
  4.  
  5. Zend_Registry::setInstance($registry);
  6.  
  7. ?>

Метод setInstance() бросает исключение Zend_Exception, если статический реестр уже был проинициализирован до первого обращения к нему.

Доступ к реестру как к массиву

Если необходимо установить или получить несколько значений, то может быть удобным использовать для этого нотацию доступа к массивам.

Example #6 Пример доступа как к массиву

  1. <?php
  2.  
  3. $registry = Zend_Registry::getInstance();
  4.  
  5. $registry['index'] = $value;
  6.  
  7. var_dump( $registry['index'] );
  8.  
  9. ?>

Доступ к реестру как к объекту

К реестру можно обращаться так же, как к объекту, используя имена индексов как имена свойств объекта. Для этого нужно специальным образом создать объект, используя опцию ArrayObject::ARRAY_AS_PROPS, и инициализировать статический экземпляр. Необходимо сделать это до того, как будет сделано первое обращение к статическому реестру. Будьте осторожны, используя эту опцию, поскольку некоторые версии PHP имеют ошибки, связанные с этой опцией.

Example #7 Пример доступа как к объекту

  1. <?php
  2.  
  3. // в загрузочном коде:
  4. $registry = new Zend_Registry(array(), ArrayObject::ARRAY_AS_PROPS)
  5. Zend_Registry::setInstance($registry);
  6. $registry->tree = 'apple';
  7.  
  8. .
  9. .
  10. .
  11.  
  12. // в различных функциях и где-либо еще в приложении:
  13. $registry = Zend_Registry::getInstance();
  14.  
  15. echo $registry->tree; // выводит "apple"
  16.  
  17. $registry->index = $value;
  18.  
  19. var_dump($registry->index);
  20.  
  21. ?>

Проверка существования индекса

Для проверки того, существует ли в реестре значение под определенным индексом, используйте isRegistered().

Example #8 Пример использования метода isRegistered()

  1. <?php
  2.  
  3. if (Zend_Registry::isRegistered($index)) {
  4.     $value = Zend_Registry::get($index);
  5. }
  6.  
  7. ?>

Для того, чтобы найти определенный индекс в объекте реестра, используйте конструкцию isset(), как в случае обычного массива.

Example #9 Пример использования метода isset()

  1. <?php
  2.  
  3. $registry = Zend_Registry::getInstance();
  4.  
  5. // используется синтаксис доступа к массиву
  6. if (isset($registry['index'])) {
  7.     var_dump( $registry['index'] );
  8. }
  9.  
  10. // используется синтаксис доступа к объекту (должен быть включен)
  11. if (isset($registry->index)) {
  12.     var_dump( $registry->index );
  13. }
  14.  
  15. ?>

Создание подклассов

Статический реестр является экземпляром класса Zend_Registry. Если вы хотите добавить в реестр дополнительный функционал, то можете создать класс, наследующий от Zend_Registry и определить его как используемый для статического реестра. Используйте статический метод setClassName() для установки класса. Этот класс должен наследовать от Zend_Registry.

Example #10 Пример установки класса статического реестра

  1. <?php
  2.  
  3. Zend_Registry::setClassName('My_Registry');
  4.  
  5. Zend_Registry::set('index', $value);
  6.  
  7. ?>

Реестр бросает исключение, если вы пытаетесь установить имя класса, используемого для статического реестра, после того, как было первое обращение к реестру. Рекомендуется устанавливать имя класса в загрузочном коде.

Уничтожение статического реестра

Хотя обычно в этом нет необходимости, вы можете уничтожить статический экземпляр реестра. Для этого используйте метод _unsetInstance().

Note: Угроза потери данных
Когда используете _unsetInstance(), все данные в статическом реестре удаляются и не могут быть восстановлены.

Вы можете применять данный метод, если, например, хотите использовать setInstance() или setClassName() после того, как был проинциализирован объект статического реестра. Уничтожение статического экземпляра дает возможность использовать эти методы.

Example #11 Пример использования метода _unsetInstance()

  1. <?php
  2.  
  3. Zend_Registry::set('index', $value);
  4.  
  5. Zend_Registry::_unsetInstance();
  6.  
  7. // изменение класса
  8. Zend_Registry::setClassName('My_Registry');
  9.  
  10. Zend_Registry::set('index', $value);
  11.  
  12. ?>

Zend_Registry