<sect1 id="zend.config.adapters.xml">
    <title>Zend_Config_Xml</title>
    <para>
        <code>Zend_Config_Xml</code> дает разработчикам возможность хранить
        конфигурационные данные в простом формате XML и читать их посредством синтаксиса
        вложенных свойств объектов. Корневой элемент файла XML не имеет значения
        и ему может быть дано любое имя. Первый уровень элементов XML
        соответствует разделам конфигурационных данных. Формат XML поддерживает
        иерархическую организацию данных через вложенность элементов
        ниже элементов уровня разделов. Содержимое конечного элемента соответствует
        значению элемента конфигурационных данных. Наследование разделов
        поддерживается через специальный атрибут <code>extends</code>, значение
        атрибута соответствует разделу, данные которого наследуются в
        раздел с этим атрибутом.
    </para>
    <note>
        <title>Тип возвращаемых данных</title>
        <para>
            Конфигурационные данные, прочитанные в <code>Zend_Config_Xml</code>,
            всегда возвращаются как строки. Приведение данных из строк к требуемым
            типам предоставляется разработчикам.
        </para>
    </note>
    <example id="zend.config.adapters.xml.example.using">
        <title>Использование <code>Zend_Config_Xml</code></title>
        <para>
            Данный пример демонстрирует основы использования <code>Zend_Config_Xml</code>
            для загрузки конфигурационных данных из файла XML. В этом примере
            используются конфигурационные данные для производственной и
            промежуточной систем. Поскольку конфигурационные данные
            промежуточной системы очень похожи на конфигурационные данные для
            производственной системы, то "промежуточный" (staging) раздел наследует от
            "производственного" (production) раздела. В данном случае выбор
            произвольный, т.е. может быть и наоборот — "производственный"
            раздел наследует от "промежуточного", хотя это может не подходить в
            более сложных случаях. Допустим, конфигурационные данные
            находятся в файле <code>/path/to/config.xml</code>:
        </para>
        <programlisting role="xml"><![CDATA[
<?xml version="1.0"?>
<configdata>
    <production>
        <webhost>www.example.com</webhost>
        <database>
            <adapter>pdo_mysql</adapter>
            <params>
                <host>db.example.com</host>
                <username>dbuser</username>
                <password>secret</password>
                <dbname>dbname</dbname>
            </params>
        </database>
    </production>
    <staging extends="production">
        <database>
            <params>
                <host>dev.example.com</host>
                <username>devuser</username>
                <password>devsecret</password>
            </params>
        </database>
    </staging>
]]>
</programlisting>
        <para>
            Далее предположим, что разработчику приложения нужны "промежуточные"
            конфигурационные данные из файла XML. Загрузить эти данные, указав
            файл XML и нужный раздел, довольно просто:
        </para>
        <programlisting role="php"><![CDATA[
$config = new Zend_Config_Xml('/path/to/config.xml', 'staging');

echo $config->database->params->host;   // выведет "dev.example.com"
echo $config->database->params->dbname; // выведет "dbname"
]]>
        </programlisting>
    </example>
    <example id="zend.config.adapters.xml.example.attributes">
        <title>Использование тегов в <code>Zend_Config_Xml</code></title>
        <para>
            Zend_Config_Xml также поддерживает два дополнительных способа
            определения узлов в конфигурации. В обоих способах используются
            атрибуты. Поскольку атрибуты <code>extends</code> и
            <code>value</code> являются зарезервированными ключевыми словами
            (<code>value</code> используется во втором способе
            с применением атрибутов), то они не должны использоваться здесь.
            Первый способ с использованием атрибутов состоит в добавлении
            атрибутов в родительский узел, они потом будут преобразованы в
            потомки этого узла:
        </para>
        <programlisting role="xml"><![CDATA[
<?xml version="1.0"?>
<configdata>
    <production webhost="www.example.com">
        <database adapter="pdo_mysql">
            <params host="db.example.com" username="dbuser" password="secret" dbname="dbname"/>
        </database>
    </production>
    <staging extends="production">
        <database>
            <params host="dev.example.com" username="devuser" password="devsecret"/>
        </database>
    </staging>
</configdata>
]]>
</programlisting>
        <para>
            Другой способ не делает конфигурацию заметно короче, но
            облегчает ее поддержку благодаря тому, что не нужно писать имена
            тегов дважды. Вы просто создаете пустой тег, значение которого
            содержится в атрибуте <code>value</code>:
        </para>
        <programlisting role="xml"><![CDATA[
<?xml version="1.0"?>
<configdata>
    <production>
        <webhost>www.example.com</webhost>
        <database>
            <adapter value="pdo_mysql"/>
            <params>
                <host value="db.example.com"/>
                <username value="dbuser"/>
                <password value="secret"/>
                <dbname value="dbname"/>
            </params>
        </database>
    </production>
    <staging extends="production">
        <database>
            <params>
                <host value="dev.example.com"/>
                <username value="devuser"/>
                <password value="devsecret"/>
            </params>
        </database>
    </staging>
</configdata>
]]>
</programlisting>
    </example>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->
