Zend_Layout Konfigurations OptionenZend_Layout hat eine Variation an Konfigurations Optionen. Diese
können durch den Aufruf entsprechender Zugriffsmethoden gesetzt werden, durch die Übergabe
eines Arrays oder Zend_Config Objektes an den Konstruktor oder
startMvc(), durch die Übergabe eines Arrays von Optionen an
setOptions(), oder der Übergabe eines
Zend_Config Objektes an setConfig().
layout: Das Layout das verwendet werden soll. Verwendet die
aktuelle Beugung um den Namen, der dem entsprechenden Layout View Skript angegeben
wurde, aufzulösen. Standardmäßig ist dieser Wert 'layout' und wird zu 'layout.phtml'
aufgelöst. Zugriffsmethoden sind setLayout() und
getLayout().
layoutPath: Der Basispfad zu den Layout View Skripten.
Zugriffsmethoden sind setLayoutPath() und
getLayoutPath().
contentKey: Die Layout Variable die für Standardinhalte
verwendet wird (wenn mit dem MVC verwendet). Der Standardwert ist
'content'. Zugriffsmethoden sind setContentKey() und
getContentKey().
mvcSuccessfulActionOnly: Wenn MVC verwendet
wird, dann wird das Layout nicht dargestellt wenn eine Aktion eine Ausnahme wirft
und dieses Flag TRUE ist (das wird verwendet um zu verhindern
dass das Layout doppelt dargestellt wird wenn das ErrorHandler
Plugin verwendet wird. Standardmäßig ist dieses Flag
TRUE. Zugriffsmethoden sind
setMvcSuccessfulActionOnly() und
getMvcSuccessfulActionOnly().
view: Das View Objekt das für die Darstellung verwendet wird.
Wenn mit MVC verwendet, dann versucht
Zend_Layout das View Objekt zu verwenden das mit dem ViewRenderer
registriert wurde wenn kein explizites View Objekt übergeben wurde. Zugriffsmethoden
sind setView() und getView().
helperClass: Die Action Helfer Klasse die verwendet wird wenn
Zend_Layout mit den MVC Komponenten
verwendet wird. Standardmäßig ist das
Zend_Layout_Controller_Action_Helper_Layout. Zugriffsmethoden
sind setHelperClass() und
getHelperClass().
pluginClass: Das Front Controller Plugin das verwendet wird
wenn Zend_Layout mit den MVC Komponenten
verwendet wird. Standardmäßig ist das
Zend_Layout_Controller_Plugin_Layout. Zugriffsmethoden sind
setPluginClass() und
getPluginClass().
inflector: Die Beugung die verwendet werden soll wenn Layout
Namen zu Layout Skript Pfaden aufgelöst werden; siehe die Zend_Layout
Beugungs Dokumentation für weitere Details. Zugriffsmethoden sind
setInflector() und getInflector().
HelferKlasse und PluginKlasse müssen an startMvc() übergeben werden
Damit die helperClass und pluginClass
Einstellungen wirken, müssen diese als Option an startMvc()
übergeben werden; wenn sie später gesetzt werden, haben Sie keinen Effekt.
Beispiele
Die folgenden Beispiele nehmen das folgende $options Array und
$config Objekt an:
'foo',
'layoutPath' => '/path/to/layouts',
'contentKey' => 'CONTENT', // Ignoriert wenn MVC nicht verwendet wird
);
]]>Optionen an den Konstruktor oder startMvc() übergeben
Beide, der Konstruktor und die statische startMvc() Methode
akzeptieren entweder ein Array von Optionen oder ein
Zend_Config Objekt mit Optionen um die
Zend_Layout Instanz zu konfigurieren.
Zuerst zeigen wir die Übergabe eines Arrays:
Und jetzt die Verwendung eines Config Objekts:
Grundsätzlich ist das der einfachste Weg um die Zend_Layout
Instanz anzupassen.
setOption() und setConfig() verwenden
Machmal ist es notwendig das Zend_Layout Objekt zu
Konfigurieren nachdem es instanziiert wurde; setOptions()
und setConfig() bieten einen schnellen und einfachen Weg
das zu tun:
setOptions($options);
// Ein Zend_Config Objekt verwenden:
$layout->setConfig($options);
]]>
Es ist zu beachten das einige Optionen, wie pluginClass und
helperClass, keinen Effekt haven wenn Sie mit Hilfe dieser
Methode übergeben werden; sie müssen mit dem Konstruktor oder der
startMvc() Methode übergeben werden.
Zugriffsmethoden verwenden
Letztendlich kann die Zend_Layout Instanz auch über
Zugriffsmetoden konfiguriert werden. Alle Zugriffsmethoden implementieren ein
Flüssiges Interface, was bedeutet das Ihre Aufrufe gekettet werden können:
setLayout('foo')
->setLayoutPath('/path/to/layouts')
->setContentKey('CONTENT');
]]>