|
|
Ressource Autoloader sind dazu gedacht Namespaced Bibliothekscode zu Managen der den Coding Standard Richtlinien vom Zend Framework folgt, welche aber kein 1:1 Mapping zwischen dem Klassennamen und der Verzeichnis Struktur haben. Ihr primärer Zweck ist es als Autoloader Anwendungs-Ressource Code zu arbeiten, wie z.B. für Anwendungs-spezifische Modelle, Formen, und ACLs.
Ressource Autoloader werden mit dem autoloader bei der Instanziierung registriert, und zwar mit dem Namespace mit dem Sie assoziiert sind. Das erlaubt es Code in speziellen Verzeichnissen zu namespacen, und trotzdem die Vorteile des Autoloadings zu nutzen.
Nehmen wir die folgende Verzeichnis Struktur an:
path/to/some/directory/
acls/
Site.php
forms/
Login.php
models/
User.php
In diesem Verzeichnis hat jeder Code ein Präfix mit dem Namespace "My_". Im Unterverzeichnis "acls" ist der Komponentenpräfix "Acl_" hinzugefügt, was letztendlich zu einem Klassennamen von "My_Acl_Site" führt. So ähnlich mappt das Unterverzeichnis "forms" auf "Form_", was zu "My_Form_Login" führt. Das Unterverzeichnis "models" hat keinen Komponenten Namespace, was zu "My_User" führt.
Man kann einen Ressource Autoloader verwenden um diese Klassen automatisch zu laden. um den Ressource Autoloader zu instanziieren ist es mindestens notwendig den Basispfad und den Namespace für die Ressourcen zu übergeben für die er verantwortlich ist:
$resourceLoader = new Zend_Loader_Autoloader_Resource(array(
'basePath' => 'path/to/some/directory',
'namespace' => 'My',
));
Note: Basis Namespace
In
Zend_Loader_Autoloaderwird erwartet das man den endenden Unterstrich ("_") im Namespace angibt wenn der eigene Autoloader verwendet wird um den Namespace zu suchen.Zend_Loader_Autoloader_Resourcenimmt an das alle Codes die man automatisch laden will ein Unterstrich Trennzeichen zwischen Namespace, Komponente und Klasse verwenden. Als Ergebnis, muß man den endenen Unterstrich nicht verwenden wenn ein Ressource Autoloader registriert wird.
Jetzt da wir den Basis Ressource Autoloader eingerichtet haben, können wir einige Komponenten zu Ihm hinzufügen um die automatisch zu Laden. Das wird mit der addResourceType() Methode getan, welche drei Argumente akzeptiert: einen Ressource "type", der intern als Referenzname verwendet wird; den Pfad des Unterverzeichnisses unter dem Basispfad in dem diese Ressource existiert; und den Namespace der Komponente die dem Basis Namespace hinzugefügt wird. Als Beispiel fügen wir jeden unserer Ressource Typen hinzu.
$resourceLoader->addResourceType('acl', 'acls/', 'Acl')
->addResourceType('form', 'forms/', 'Form')
->addResourceType('model', 'models/');
Alternativ können diese als Array an addResourceTypes() übergeben werden; das folgende ist äquivalent zu dem obigen:
$resourceLoader->addResourceTypes(array(
'acl' => array(
'path' => 'acls/',
'namespace' => 'Acl',
),
'form' => array(
'path' => 'forms/',
'namespace' => 'Form',
),
'model' => array(
'path' => 'models/',
),
));
Letztendlich kann alles davon spezifiziert werden wenn das Objekt instanziiert wird indem einfach ein "resourceTypes" Schlüssel in den Optionen spezifiziert und übergeben wird, sowie eine Struktur wie anbei:
$resourceLoader = new Zend_Loader_Autoloader_Resource(array(
'basePath' => 'path/to/some/directory',
'namespace' => 'My',
'resourceTypes' => array(
'acl' => array(
'path' => 'acls/',
'namespace' => 'Acl',
),
'form' => array(
'path' => 'forms/',
'namespace' => 'Form',
),
'model' => array(
'path' => 'models/',
),
),
));
Zend Framework wird mit einer konkreten Implementation von
Zend_Loader_Autoloader_Resource ausgeliefert die Ressourcen Typen
enthält welche den notwendigen Standard Verzeichnisstrukturen für Zend Framework MVC
Anwendungen entsprechen. Diese Lader,
Zend_Application_Module_Autoloader, kommt mit den folgenden
Mappings:
api/ => Api
forms/ => Form
models/ => Model
DbTable/ => Model_DbTable
plugins/ => Plugin
Wenn man, als Beispiel, ein Modul mit dem Präfix "Blog_" hat, und die Klasse "Blog_Form_Entry" instanziieren will, würde diese in den Ressourcen Verzeichnis "forms/" im Unterverzeichnis nach einer Datei die "Entry.php" heißt suchen.
Wenn Modul Bootstraps mit Zend_Application verwendet werden, wird
standardmäßig eine Instanz von Zend_Application_Module_Autoloader
für jede eigene Modul erstellt, was es erlaubt Modul Ressource automatisch zu laden.
|
|
Copyright © 2005-2011 Zend Technologies Inc (compiled by mikaelkael with ZFDocumentor - SVN 18616).

