documentation/manual/ru/module_specs/Zend_Config-TheoryOfOperation.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <sect1 id="zend.config.theory_of_operation">
   4     <title>Теоретические основы работы с Zend_Config</title>
   5
   6     <para>
   7         Конфигурационные данные передаются конструктору <classname>Zend_Config</classname>
   8         в виде ассоциативного массива, который может быть многомерным, что
   9         дает возможность организовывать данные от общего к частному. Классы
  10         адаптеров преобразуют конфигурационные данные из хранилища в
  11         ассоциативный массив для конструктора <classname>Zend_Config</classname>.
  12         Можно также передавать массивы непосредственно конструктору
  13         <classname>Zend_Config</classname>
  14         без использования класса адаптера, т.к. это может быть наиболее
  15         подходящим решением в некоторых ситуациях.
  16     </para>
  17
  18     <para>
  19         Каждое значение массива конфигурационных значений становится свойством
  20         объекта <classname>Zend_Config</classname>. Ключ массива используется как имя
  21         свойства. Если значение само является массивом, то соответствующее
  22         свойство создается как объект <classname>Zend_Config</classname>, который
  23         заполняется данными этого массива. Это производится рекурсивно, т.о.,
  24         иерархия конфигурационных данных может иметь любой уровень вложенности.
  25     </para>
  26
  27     <para>
  28         <classname>Zend_Config</classname> реализует интерфейсы <emphasis>Countable</emphasis>
  29         и <emphasis>Iterator</emphasis> для того, чтобы обеспечить простой доступ
  30         к конфигурационным данным. Поэтому с объектами
  31         <classname>Zend_Config</classname> можно использовать функцию
  32         <ulink url="http://php.net/count"><methodname>count()</methodname></ulink> и
  33         такие конструкции языка <acronym>PHP</acronym>, как
  34         <ulink url="http://php.net/foreach"><emphasis>foreach</emphasis></ulink>.
  35     </para>
  36
  37     <para>
  38         По умолчанию через <classname>Zend_Config</classname> конфигурационные данные
  39         доступны только для чтения, и операция присваивания (например,
  40         <command>$config->database->host = 'example.com'</command>)
  41         вызовет исключение. Тем не менее, это поведение
  42         может быть отменено при вызове конструктора, и тогда
  43         можно будет изменять конфигурационные данные.
  44         Если модификации разрешены, то <classname>Zend_Config</classname> также
  45         поддерживает уничтожение значений
  46         (т.е. <methodname>unset($config->database->host)</methodname>).
  47         Метод <methodname>readOnly()</methodname> может использоваться для определения того,
  48         был ли разрешены модификации в данном объекте <classname>Zend_Config</classname>.
  49         Метод <methodname>setReadOnly()</methodname> запрещает все дальнейшие изменения в
  50         объекте <classname>Zend_Config</classname>, который был создан с разрешением
  51         изменений.
  52     </para>
  53
  54     <note>
  55         <para>
  56             Важно не путать изменение данных в памяти с сохранением
  57             конфигурационных данных на физическом носителе данных. Создание
  58             и изменение конфигурационных данных на различных
  59             носителях данных не входит в сферу назначений <classname>Zend_Config</classname>.
  60             Для создания и изменения конфигурационных данных на различных
  61             носителях информации можно использовать
  62             сторонние разработки с открытым исходным кодом.
  63         </para>
  64     </note>
  65
  66     <para>
  67         Классы адаптеров наследуют от класса <classname>Zend_Config</classname>,
  68         и, следовательно, имеют тот же функционал.
  69     </para>
  70
  71     <para>
  72         Семейство классов <classname>Zend_Config</classname> позволяет
  73         организовывать конфигурационные данные, разбивая их на разделы.
  74         В объекты адаптеров <classname>Zend_Config</classname> можно загружать
  75         один определенный раздел, несколько разделов или все разделы
  76         данных (если не указан раздел).
  77     </para>
  78
  79     <para>
  80         Классы адаптеров <classname>Zend_Config</classname> поддерживают единую модель
  81         наследования, которая позволяет одному разделу наследовать
  82         конфигурационные данные из другого. Это сделано для того, чтобы
  83         уменьшить или устранить необходимость дублирования конфигурационных
  84         данных разного назначения. Наследующий раздел может замещать данные,
  85         унаследованные от родительского раздела. Как и при наследовании классов PHP,
  86         раздел может наследовать от родительского раздела, который в свою очередь
  87         наследует от другого и т.д., но множественное наследование (т.е. раздел
  88         C наследует напрямую от разделов A и B) не поддерживается.
  89     </para>
  90
  91     <para>
  92         Если вы имеете два объекта <classname>Zend_Config</classname>, то можете объединить
  93         их в один, используя функцию <methodname>merge()</methodname>. Например, имея
  94         <varname>$config</varname> и <varname>$localConfig</varname> вы можете объединить
  95         данные из <varname>$localConfig</varname> с данными из <varname>$config</varname>,
  96         используя <methodname>$config->merge($localConfig)</methodname>. Элементы
  97         из <varname>$localConfig</varname> при совпадении имен заменят собой элементы
  98         <varname>$config</varname>.
  99     </para>
 100
 101     <note>
 102         <para>
 103             Объект <classname>Zend_Config</classname>, который выполняет объединение,
 104             должен быть создан с разрешением модификаций путем передачи
 105             <constant>TRUE</constant> в качестве второго параметра конструктора.
 106             После того, как объединение будет завершено, можно использовать
 107             метод <methodname>setReadOnly()</methodname> для предотвращения всех
 108             дальнейших изменений.
 109         </para>
 110     </note>
 111 </sect1>
 112 <!--
 113 vim:se ts=4 sw=4 et:
 114 -->