repo_zf1/documentation/manual/de/module_specs/Zend_Config-Introduction.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 15103 -->
<!-- Reviewed: no -->
<sect1 id="zend.config.introduction">
    <title>Einleitung</title>
    <para>
        <classname>Zend_Config</classname> wurde entworfen um den Zugriff auf und die Verwendung von
        Konfigurations-Daten zu vereinfachen. Es stellt diese Konfigurations-Daten innerhalb
        der Applikation über eine verschachtelte Objekt-Struktur zur Verfügung. Die
        Konfigurations-Daten können aus verschiedenen Datenquellen gelesen werden,
        die hierarchische Datenspeicherung unterstützen. Derzeit stellt <classname>Zend_Config</classname>
        mit <link linkend="zend.config.adapters.ini"><classname>Zend_Config_Ini</classname></link> und
        <link linkend="zend.config.adapters.xml"><classname>Zend_Config_Xml</classname></link> Adapter für
        das Einlesen von Daten aus Textfiles zur Verfügung.
    </para>
    <example id="zend.config.introduction.example.using">
        <title><code>Zend-Config</code> verwenden</title>
        <para>
            In der Regel geht man davon aus, dass Anwender eine der Adapter-Klassen wie
            <link linkend="zend.config.adapters.ini"><classname>Zend_Config_Ini</classname></link> oder
            <link linkend="zend.config.adapters.xml"><classname>Zend_Config_Xml</classname></link>
            verwenden. Wenn die Konfigurations-Daten aber als PHP-Array vorliegen, können diese
            auch einfach an den <classname>Zend_Config</classname>-Konstruktor übergeben werden, um dann
            über die objektorientierte Schnittstelle auf sie zugreifen zu können:
        </para>
        <programlisting role="php"><![CDATA[
// Gegeben ist ein Array mit Konfigurations-Daten
$configArray = array(
    'webhost'  => 'www.example.com',
    'database' => array(
        'adapter' => 'pdo_mysql',
        'params'  => array(
            'host'     => 'db.example.com',
            'username' => 'dbuser',
            'password' => 'secret',
            'dbname'   => 'mydatabase'
        )
    )
);

// Erstelle das objektorientierte Interface zum Datenzugriff
$config = new Zend_Config($configArray);

// Gebe einen Eintrag aus (Ausgabe ist 'www.example.com')
echo $config->webhost;

// Konfigurations-Daten benutzen, um eine Datenbank-Verbindung her zu stellen
$db = Zend_Db::factory($config->database->adapter,
                       $config->database->params->toArray());

// Alternative Verwendung: einfach das Zend_Config Objekt übergeben.
// Zend_Db factory weiß wie es zu interpretieren ist.
$db = Zend_Db::factory($config->database);
]]>
        </programlisting>
    </example>
    <para>
        Wie das Beispiel oben zeigt, kann man über <classname>Zend_Config</classname> auf die
        Konfigurations-Daten aus dem übergebenen Array so zugreifen, wie auf die Eigenschaften
        einer verschachtelten Objekt-Struktur.
    </para>
    <para>
        Zusätzlich zum objektorientierten Zugriff auf die Daten Werte hat <classname>Zend_Config</classname>
        <code>get()</code> welches den unterstützten Standardwert zurückgibt wenn das Daten Element
        nicht existiert. Zum Beispiel:
    </para>
    <programlisting role="php"><![CDATA[
$host = $config->database->get('host', 'localhost');
]]>
    </programlisting>
    <example id="zend.config.introduction.example.file.php">
        <title><classname>Zend_Config</classname> mit einer PHP Konfigurationsdatei verwenden</title>
        <para>
            Es ist oft gewünscht eine reine PHP-basierende Konfigurationsdatei zu verwenden. Der folgende
            Code zeigt wie das ganz einfach erreicht werden kann:
        </para>
        <programlisting role="php"><![CDATA[
// config.php
return array(
    'webhost'  => 'www.example.com',
    'database' => array(
        'adapter' => 'pdo_mysql',
        'params'  => array(
            'host'     => 'db.example.com',
            'username' => 'dbuser',
            'password' => 'geheim',
            'dbname'   => 'mydatabase'
        )
    )
);
]]>
        </programlisting>
        <programlisting role="php"><![CDATA[
// Konfiguration konsumieren
$config = new Zend_Config(require 'config.php');

// Einen Konfigurationswert ausgeben (führt zu 'www.example.com')
echo $config->webhost;
]]>
        </programlisting>
    </example>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->