Programmer's Reference Guide
| Zend_Layout Schnellstart |
Zend_Layout Konfigurations Optionen
Zend_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()undgetLayout(). -
layoutPath: Der Basispfad zu den Layout View Skripten. Zugriffsmethoden sind
setLayoutPath()undgetLayoutPath(). -
contentKey: Die Layout Variable die für Standardinhalte verwendet wird (wenn mit dem MVC verwendet). Der Standardwert ist 'content'. Zugriffsmethoden sind
setContentKey()undgetContentKey(). -
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 das das Layout doppelt dargestellt wird wen das ErrorHandler Plugin verwendet wird. Standardmäßig ist dieses Flag true. Zugriffsmethoden sind
setMvcSuccessfulActionOnly()undgetMvcSuccessfulActionOnly(). -
view: Das View Objekt das für die Darstellung verwendet wird. Wenn mit MVC verwendet, dann versucht
Zend_Layoutdas View Objekt zu verwenden das mit dem ViewRenderer registriert wurde wenn kein explizites View Objekt übergeben wurde. Zugriffsmethoden sindsetView()undgetView(). -
helperClass: Die Action Helfer Klasse die verwendet wird wenn
Zend_Layoutmit den MVC Komponenten verwendet wird. Standardmäßig ist dasZend_Layout_Controller_Action_Helper_Layout. Zugriffsmethoden sindsetHelperClass()undgetHelperClass(). -
pluginClass: Das Front Kontroller Plugin das verwendet wird wenn
Zend_Layoutmit den MVC Komponenten verwendet wird. Standardmäßig ist dasZend_Layout_Controller_Plugin_Layout. Zugriffsmethoden sindsetPluginClass()undgetPluginClass(). -
inflector: Die Beugung die verwendet werden soll wenn Layout Namen zu Layout Skript Pfaden aufgelöst werden; siehe die
Zend_LayoutBeugungs Dokumentation für weitere Details. Zugriffsmethoden sindsetInflector()undgetInflector().
Hinweis: HelferKlasse und PluginKlasse müssen an startMvc() übergeben werden
Damit diehelperClassundpluginClassEinstellungen wirken, müssen diese als Option anstartMvc()ü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:
$options = array(
'layout' => 'foo',
'layoutPath' => '/path/to/layouts',
'contentKey' => 'CONTENT', // Ignoriert wenn MVC nicht verwendet wird
);
/**
[layout]
layout = "foo"
layoutPath = "/path/to/layouts"
contentKey = "CONTENT"
*/
$config = new Zend_Config_Ini('/path/to/layout.ini', 'layout');
Beispiel #1 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:
// Konstruktor verwenden:
$layout = new Zend_Layout($options);
// startMvc() verwenden:
$layout = Zend_Layout::startMvc($options);
Und jetzt die Verwendung eines Config Objekts:
$config = new Zend_Config_Ini('/path/to/layout.ini', 'layout');
// Konstruktor verwenden:
$layout = new Zend_Layout($config);
// startMvc() verwenden:
$layout = Zend_Layout::startMvc($config);
Grundsätzlich ist das der einfachste Weg um die Zend_Layout Instanz anzupassen.
Beispiel #2 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:
// Ein Array von Optionen verwenden:
$layout->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.
Beispiel #3 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:
$layout->setLayout('foo')
->setLayoutPath('/path/to/layouts')
->setContentKey('CONTENT');
| Zend_Layout Schnellstart |
