Zend_Application Quick Start

Theorie der Funktionsweise

Um eine MVC Anwendung zu konfigurieren und bereit zur Auslieferung zu bekommen wird ein immer größerer Anteil an Code benötigt sobald mehr Features verfügbar sind: Setzen der Datenbank, Konfiguration der View und View Helfer, Konfiguration der Layouts, Registrierung der Plugins, Registrierung der Aktion Helfer, und andere.

Zusätzlich will man oft den gleichen Code wiederverwenden um Tests zu bootstrappen, einen Cronjob, oder ein Service Skript zu haben. Wärend es sehr einfach ist sein Bootstrap Skript einzubauen, gibt es oft Initialisierungen die abhängig sind von der Umgebung - man könnte kein MVC für einen Cronjob benötigen, oder nur den DB Layer für ein Service Skript.

Zend_Application zielt darauf ab das alles einfacher zu machen und bietet Wiederwervendbarkeit durch die Kapselung vom Bootstrapping in OOP Paradigmen.

Zend_Application ist in drei Bereiche geteilt:

  • Zend_Application: Lädt die PHP Umgebung, inklusive Inklude-Pfade und Autoloading, und instanziiert die benötigte Bootstrap Klasse.

  • Zend_Application_Bootstrap: Bietet Interfaces für Bootstrap Klassen. Zend_Application_Bootstrap_Bootstrap bietet übliche Funktionalitäten für die meisten Notwendigkeiten des Bootstrappings, inklusive Angorithmen um Abhängigkeiten zu prüfen und die Möglichkeit Bootstrap Ressourcen bei Bedarf zu laden.

  • Zend_Application_Resource bietet ein Interface für Standard Bootstrap Ressourcen die bei Bedarf von einer Bootstrap Instanz geladen werden können, sowie verschiedene standardmäßige Ressource Implementationen.

Entwickler erstellen eine Bootstrap Klasse für Ihre Anwendung und erweitern Zend_Application_Bootstrap_Bootstrap oder implementieren (mindestens) Zend_Application_Bootstrap_BootstrapAbstract. Der Einstiegspunkt (z.B. public/index.php) lädt Zend_Application und initialisiert Sie, indem folgendes übergeben wird:

  • Die aktuelle Umgebung

  • Optionen für das Bootstrapping

Die Bootstrap Optionen enthalten den Pfad zur Datei welche die Bootstrap Klasse enthält und optional:

  • Jeden include_path der extra zu setzen ist

  • Jeden Autoloader Namespace der zusätzlich zu registrieren ist

  • Jede php.ini Einstellung die zu initialisieren ist

  • Den Klassennamen für die Bootstrap Klasse (wenn diese nicht "Bootstrap" ist)

  • Ressourcen Präfix zu Pfad Paare die zu verwenden sind

  • Jede Ressource die zu verwenden ist (durch Name der Klasse oder Kurzname)

  • Zusätzliche Pfade zu einer Konfigurationsdatei die zu laden ist

  • Zusätzliche Konfigurations Optionen

Optionen können, ein Array, ein Zend_Config Objekt, oder der Pfad zu einer Konfigurationsdatei sein.

Bootstrapping

Zend_Application's zweites Feld der Arbeit ist die Ausführung des Bootstraps der Anwendung. Bootstraps müssen mindestens Zend_Application_Bootstrap_Bootstrapper implementieren, welches die folgende API definiert:

  1. interface Zend_Application_Bootstrap_Bootstrapper
  2. {
  3.     public function __construct($application);
  4.     public function setOptions(array $options);
  5.     public function getApplication();
  6.     public function getEnvironment();
  7.     public function getClassResources();
  8.     public function getClassResourceNames();
  9.     public function bootstrap($resource = null);
  10.     public function run();
  11. }

Diese API erlaubt es dem Bootstrap die Umgebung und die Konfiguration vom Objekt der Anwendung zu akzeptieren, die Ressourcen die für das Bootstrapping verantwortlich sind zu melden, und dann das Bootstrappen ausführen und die Anwendung zu starten.

Man kann dieses Interface selbst implementieren, Zend_Application_Bootstrap_BootstrapAbstract erweitern, oder Zend_Application_Bootstrap_Bootstrap verwenden.

Neben dieser Funktionalität gibt es eine Anzahl anderer Gebiete von Interesse mit denen man vertraut sein sollte.

Methoden für Ressourcen

Die Implementation von Zend_Application_Bootstrap_BootstrapAbstract bietet eine einfache Konvention für die Definition von Methoden für Ressourcen Klassen. Jede geschützte Methode (protected), deren Name mit _init beginnt wird als Ressourcemethode angenommen.

Um eine einzelne Ressource Methode zu bootstrappen, muß die bootstrap() Methode verwendet, und der Name der Ressource übergeben werden. Der Name ist der Name der Methode ohne den _init Präfix.

Um mehrere Ressourcen Methoden zu bootstrappen, muß ein Array von Namen übergeben werden. Um alle Ressourcen Methoden zu bootstrappen, darf nichts übergeben werden.

Nehmen wir die folgende Bootstrap Klasse an:

  1. class Bootstrap extends Zend_Application_Bootstrap_Bootstrap
  2. {
  3.     protected function _initFoo()
  4.     {
  5.         // ...
  6.     }
  7.  
  8.     protected function _initBar()
  9.     {
  10.         // ...
  11.     }
  12.  
  13.     protected function _initBaz()
  14.     {
  15.         // ...
  16.     }
  17. }

Um nur die _initFoo() Methode zu bootstrappen, machen wir das folgende:

  1. $bootstrap->bootstrap('foo');

Um die Methoden _initFoo() und _initBar() zu bootstrappen, machen wir das folgende:

  1. $bootstrap->bootstrap(array('foo', 'bar'));

Um alle Ressourcen Methoden zu bootstrappen, rufen wir bootstrap() ohne Argumente auf:

  1. $bootstrap->bootstrap();

Bootstraps die Ressourcen Plugins benutzen

Um Bootstraps wiederverwendbarer zu machen wurde die Fähigkeit zur Verfügung gestellt Ressourcen in Ressource Plugin Klassen zu geben. Das erlaubt es Ressourcen einfach über die Konfiguration zu mischen und zu sehen ob Sie passen. Wir behandeln später wie Ressourcen erstellt werden; in diesem Abschnitt zeigen wir nur wie Sie angepasst werden können.

Wenn die Bootstrap dazu in der Lage sein soll Ressource Plugins zu verwenden muß man ein zusätzliches Interface implementieren, Zend_Application_Bootstrap_ResourceBootstrapper. Dieses Interface definiert eine API für das Erkennen, Registrieren und Laden von Ressource Plugins:

  1. interface Zend_Application_Bootstrap_ResourceBootstrapper
  2. {
  3.     public function registerPluginResource($resource, $options = null);
  4.     public function unregisterPluginResource($resource);
  5.     public function hasPluginResource($resource);
  6.     public function getPluginResource($resource);
  7.     public function getPluginResources();
  8.     public function getPluginResourceNames();
  9.     public function setPluginLoader(Zend_Loader_PluginLoader_Interface $loader);
  10.     public function getPluginLoader();
  11. }

Ressource Plugins bieten grundsätzlich die Fähigkeit Ressource Initialisierer zu Erstellen die zwischen Anwendungen wiederverwendet werden können. Das erlaubt es die aktuelle Bootstrap relativ klein zu halten, und neue Ressourcen einzuführen ohne Sie in der Bootstrap selbst anzugreifen.

Zend_Application_Bootstrap_BootstrapAbstract (und bei Erweiterung Zend_Application_Bootstrap_Bootstrap) implementiert dieses Interface genauso, und erlaubt es Ressource Plugins zu verwenden.

Um Ressource Plugins zu verwenden müssen diese in den Optionen spezifiziert werden, die dem Anwendungs Objekt und-oder der Bootstrap übergeben werden. Diese Optionen können von einer Konfigurationsdatei kommen, oder manuell übergeben werden. Optionen sind Paare von Schlüssel zu Optionspaaren, wobei der Schlüssel den Namen der Ressource repräsentiert. Der Ressourcename ist das Segment das dem Klassenpräfix folgt. Die Ressourcen, die zum Beispiel mit Zend Framework ausgeliefert werden, haben den Klassenpräfix "Zend_Application_Resource_"; alles was folgt würde der Name der Ressource sein. Als Beispiel:

  1. $application = new Zend_Application(APPLICATION_ENV, array(
  2.     'resources' => array(
  3.         'FrontController' => array(
  4.             'controllerDirectory' => APPLICATION_PATH . '/controllers',
  5.         ),
  6.     ),
  7. ));

Das zeigt das die "FrontController" verwendet werden sollte, mit den spezifizierten Optionen.

Wenn man beginnt eigene Ressource Plugins zu schreiben, oder Ressource Plugins von dritten anzupassen, muß man der eigenen Bootstrap mitteilen wo nach Ihnen zu suchen ist. Intern verwendet die Bootstrap Zend_Loader_PluginLoader so dass man nur die üblichen Klassenpräfix und Pfadpaare angeben muß.

Als Beispiel nehmen wir an das wir eigene Ressource Plugins in APPLICATION_PATH/resources/ haben, und das sie den gemeinsamen Klassenpräfix My_Resource teilen. Man würde diese Information de Anwendungsobjekt wie folgt übergeben:

  1. $application = new Zend_Application(APPLICATION_ENV, array(
  2.     'pluginPaths' => array(
  3.         'My_Resource' => APPLICATION_PATH . '/resources/',
  4.     ),
  5.     'resources' => array(
  6.         'FrontController' => array(
  7.             'controllerDirectory' => APPLICATION_PATH . '/controllers',
  8.         ),
  9.     ),
  10. ));

Man ist jetzt in der Lage Ressource von diesem Verzeichnis zu verwenden.

Wie Ressource Methoden kann die bootstrap() Methode verwendet werden um Ressource Plugins zu verwenden. Wie bei Ressource Methoden kann man entweder einzelne Ressource Plugins spezifizieren, mehrere Plugins (über ein Array), oder alle Plugins. Zusätzlich kann man mischen und entsprechende Ressource Methoden genauso ausführen.

  1. // Eine ausführen:
  2. $bootstrap->bootstrap('FrontController');
  3.  
  4. // Mehrere ausführen:
  5. $bootstrap->bootstrap(array('FrontController', 'Foo'));
  6.  
  7. // Alle Ressource Methoden und Plugins ausführen:
  8. $bootstrap->bootstrap();

Ressource Registry

Viele, wenn nicht sogar alle, der eigenen Ressource Methoden oder Plugins initialisieren Objekte, und in vielen Fällen werden diese Objekte an anderen Orten der Anwendung benötigt. Wie man auf Sie zugreifen?

Zend_Application_Bootstrap_BootstrapAbstract bietet eine locale Registry für diese Objekte. Um eigene Objekte in Ihr zu Speichern müssen diese einfach von den eigenen Ressourcen zurückgegeben werden.

Für maximale Flexibilität wird diese Registry intern als "Container" bezeichnet; die einzige Voraussetzung ist das es ein Objekt ist. Ressourcen werden dann als Eigenschaften registriert die nach dem Namen der Ressource benannt sind. Standardmäßig wird eine Instanz von Zend_Registry verwendet, man kann aber jedes andere Objekt spezifizieren wenn man das will. Die Methoden setContainer() und getContainer() können verwendet werden um den Container selber zu manipulieren. getResource($resource) kann verwendet werden um eine angegebene Ressource vom Container zu holen, und hasResource($resource) um zu prüfen ob die Ressource aktuell schon registriert wurde.

Als Beispiel nehmen wir eine grundsätzliche View Ressource an:

  1. class Bootstrap extends Zend_Application_Bootstrap_Bootstrap
  2. {
  3.     protected function _initView()
  4.     {
  5.         $view = new Zend_View();
  6.         // weitere Initialisierungen...
  7.  
  8.         return $view;
  9.     }
  10. }

Man kann Sie prüfen und-oder Sie wie folgt holen:

  1. // Verwendung der has- und getResource() Paare:
  2. if ($bootstrap->hasResource('view')) {
  3.     $view = $bootstrap->getResource('view');
  4. }
  5.  
  6. // Über den Container:
  7. $container = $bootstrap->getContainer();
  8. if (isset($container->view)) {
  9.     $view = $container->view;
  10. }

Es ist zu beachten das die Registry und auch der Container nicht global sind. Das bedeutet das man auf die Bootstrap zugreifen muß um Ressourcen zu holen. Zend_Application_Bootstrap_Bootstrap bietet einige Bequemlichkeiten hierfür: wärend der Ausführung von run(), registriert Sie sich als Front Controller Parameter "bootstrap", was es erlaubt Sie von Routern, Dispatchern, Plugins, und Action Controllern zu holen.

Wenn man, als Beispiel, auf die View Ressource von oben im eigenen Action Controller zugreifen will, kann man das wie folgt tun:

  1. class FooController extends Zend_Controller_Action
  2. {
  3.     public function init()
  4.     {
  5.         $bootstrap = $this->getInvokeArg('bootstrap');
  6.         $view = $bootstrap->getResource('view');
  7.         // ...
  8.     }
  9. }

Erkennen von Abhängigkeiten

Zusätzlich zur Ausführung von Ressource Methoden und Plugins, ist es notwendig sicherzustellen das diese einmal und wirklich nur einmal ausgeführt werden; Sie sollen eine Anwendung bootstrappen, und die mehrfache Ausführung von Ihnen kann zu einem Overhead von Ressourcen führen.

Zur gleichen Zeit können Ressourcen von anderen ausgeführten Ressourcen abhängen. Um diese zwei Fälle zu lösen bietet Zend_Application_Bootstrap_BootstrapAbstract einen einfachen und effektiven Mechanismus für die Erkennung von Abhängigkeiten.

Wie vorher erwähnt werden alle Ressourcen -- ob Methoden oder Plugins -- durch den Aufruf von bootstrap($resource) gebootstrappt, wobei $resource der Name einer Ressource ist, ein Array von Ressourcen oder leer gelassen wird, was zeigt das alle Ressourcen ausgeführt werden sollen.

Wenn eine Ressource von anderen Ressourcen abhängig ist, sollte Sie in Ihrem Code bootstrap() aufrufen um sicherzustellen das die Ressource ausgeführt wurde. Weitere Aufrufe von Ihr werden dann ignoriert.

In einer Ressource Methode würde so ein Aufruf wie folgt aussehen:

  1. class Bootstrap extends Zend_Application_Bootstrap_Bootstrap
  2. {
  3.     protected function _initRequest()
  4.     {
  5.         // Sicherstellen das der Front Controlle initialisiert wird
  6.         $this->bootstrap('FrontController');
  7.  
  8.         // Den Front Controller von der Bootstrap Registry erhalten
  9.         $front = $this->getResource('FrontController');
  10.  
  11.         $request = new Zend_Controller_Request_Http();
  12.         $request->setBaseUrl('/foo');
  13.         $front->setRequest($request);
  14.  
  15.         // Sicherstellen das die Anfrage in der Bootstrap Registry
  16.         // gespeichert ist
  17.         return $request;
  18.     }
  19. }

Ressource Plugins

Wie vorher erwähnt ist die Verwendung von Ressource Plugins ein guter Weg um wiederverwendbare Bootstrap Ressourcen zu erstellen und um so viel wie möglich vom eigenen Code in diskrete Klassen auszulagern. Wärend Zend Framework mit einer Anzahl von standardmäßigen Ressource Plugins geliefert wird, besteht das Ziel darin das der Entwickler eigene schreiben sollte um seine eigenen Notwendigkeiten der Initialisierung zu kapseln.

Ressource Plugins müssen nur Zend_Application_Resource_Resource implementieren, oder einfach Zend_Application_Resource_ResourceAbstract erweitern. Das grundsätzliche Interface ist folgendes:

  1. interface Zend_Application_Resource_Resource
  2. {
  3.     public function __construct($options = null);
  4.     public function setBootstrap(
  5.         Zend_Application_Bootstrap_Bootstrapper $bootstrap
  6.     );
  7.     public function getBootstrap();
  8.     public function setOptions(array $options);
  9.     public function getOptions();
  10.     public function init();
  11. }

Das Interface definiert einfach was ein Ressouce Plugin an Optionen im Konstruktor akzeptieren sollte, Mechanismen für das Setzen und Empfangen von Optionen, Mechanismen für das Setzen und Empfangen des Bootstrap Objekts, und eine Initialisierungs-Methode hat.

Als Beispiel nehmen wir an das wir eine normale View Initialisierung haben die in der eigenen Anwendung verwendet wird. Man hat normale Doctype, CSS und Javascript, und will in der Lage sein diese in einem basis Dokumententitel über die Konfiguration zu übergeben. So ein Ressource Plugin könnte wie folgt aussehen:

  1. class My_Resource_View extends Zend_Application_Resource_ResourceAbstract
  2. {
  3.     protected $_view;
  4.  
  5.     public function init()
  6.     {
  7.         // Die View zurückgeben damit die Bootstrap Sie
  8.         // in der Registry speichert
  9.         return $this->getView();
  10.     }
  11.  
  12.     public function getView()
  13.     {
  14.         if (null === $this->_view) {
  15.             $options = $this->getOptions();
  16.             $title   = '';
  17.             if (array_key_exists('title', $options)) {
  18.                 $title = $options['title'];
  19.                 unset($options['title']);
  20.             }
  21.  
  22.             $view = new Zend_View($options);
  23.             $view->doctype('XHTML1_STRICT');
  24.             $view->headTitle($title);
  25.             $view->headLink()->appendStylesheet('/css/site.css');
  26.             $view->headScript()->appendfile('/js/analytics.js');
  27.  
  28.             $viewRenderer =
  29.                 Zend_Controller_Action_HelperBroker::getStaticHelper(
  30.                     'ViewRenderer'
  31.                 );
  32.             $viewRenderer->setView($view);
  33.  
  34.             $this->_view = $view;
  35.         }
  36.         return $this->_view;
  37.     }
  38. }

Solange man den Präfix Pfad für dieses Ressource Plugin registriert, kann es in der eigenen Anwendung verwendet werden. Besser, weil der Plugin Loader verwendet wird, ist es die gelieferten "View" Ressource Plugin zu überschreiben, und sicherzustellen das man stattdessen die eigene verwendet.


Zend_Application Quick Start