Zend_Config_Writer
Zend_Config_Writer gibt einem die Möglichkeit Configdateien aus Zend_Config
Objekten heraus zu schreiben. Es arbeitet mit einem Adapter-artigen System und ist deswegen sehr
einfach zu verwenden. Standardmäßig wird Zend_Config_Writer mit drei Adaptern
ausgeliefert, die alle gleich funktionieren. Der Writer wird mit speziellen Optionen instanziert,
welche filename und config sein können. Dann wird die write()
Methode des Writers aufgerufen und die Configdatei wird erstellt. Man kann $filename
und $config auch direkt an die write() Methode übergeben. Aktuell werden
die folgenden Writer mit Zend_Config_Writer ausgeliefert:
Zend_Config_Writer_Array
Zend_Config_Writer_Ini
Zend_Config_Writer_Xml
Als Ausnahme hat Zend_Config_Writer_Ini einen zusätzlichen optionalen Parameter
nestSeparator, welche definiert mit welchem Zeichen die einzelnen Nodes getrennt werden.
Der Standard ist ein einzelner Punkt, wie er standardmäßig von Zend_Config_Ini
akzeptiert wird.
Wenn ein Zend_Config Objekt geändert oder erstellt wird, muß man einige Dinge wissen.
Um einen Wert zu erstellen oder zu ändern muß einfach der Parameter des Zend_Config
Objektes über den Zugriffsaccessor (->) gesetzt werden. Um eine Sektion im Root
oder im Branch zu erstellen muß einfach ein neues Aray erstellt werden
($config->branch = array();). Um zu definieren welche Sektion eine andere
erweitert, muß die setExtend() Methode am Root Zend_Config Objekt
aufgerufen werden.
Verwenden von Zend_Config_Writer
Dieses Beispiel zeigt die grundsätzliche Verwendung von Zend_Config_Writer_Xml
um eine neue Konfigurationsdatei zu erstellen:
production = array();
$config->staging = array();
$config->setExtend('staging', 'production');
$config->production->db = array();
$config->production->db->hostname = 'localhost';
$config->production->db->username = 'production';
$config->staging->db = array();
$config->staging->db->username = 'staging';
// Die Config Datei auf einem der folgenden Wege schreiben:
// a)
$writer = new Zend_Config_Writer_Xml(array('config' => $config,
'filename' => 'config.xml'));
$writer->write();
// b)
$writer = new Zend_Config_Writer_Xml();
$writer->setConfig($config)
->setFilename('config.xml')
->write();
// c)
$writer = new Zend_Config_Writer_Xml();
$writer->write('config.xml', $config);
]]>
Das erstellt eine XML Config Datei mit den Sektionen production und staging, wobei staging
production erweitert.
Eine bestehende Config ändern
Dieses Beispiel zeigt wie eine bestehende Config Datei bearbeitet werden kann.
true,
'allowModifications' => true));
// Ändere einen Wert
$config->production->hostname = 'foobar';
// Schreibe die Config Datei
$writer = new Zend_Config_Writer_Ini(array('config' => $config,
'filename' => 'config.ini'));
$writer->write();
]]>
Laden einer Config Datei
Beim Laden einer bestehenden Config Datei für eine Änderung ist es sehr wichtig das alle
Sektionen geladen werden und die Erweiterungen übersprungen werden, sodas keine Werte
zusammengefügt werden. Das wird durch die Übergabe von skipExtends als Option
an den Constructor durchgeführt.