Zend_Loader_Autoloader
ist eine vollständige Autoloader Lösung für
den Zend Framework. Sie wurde entwickelt um verschiedene Ziele zu lösen:
-
Einen echten Namespace Autoloader bieten. (Frühere Inkarnationen waren mit Namespaces auf Benutzerebene verknüpft)
-
Es zu erlauben eigene Callbacks als Autoloader zu registrieren und diese als Stack zu managen. (Zu der als das geschrieben wirde gab es einige Probleme mit
spl_autoload
, welche es nicht erlaubten einen Callback erneut zu registrieren wenn dieser eine Instanzmethode verwendet.) -
Er zu erlauben Namespaces optimiert zu matchen um schnellere Auflösung der Klasse zu erlauben.
Zend_Loader_Autoloader
implementiert ein Singleton, was es universell
verwendbar macht. Das bietet die Möglichkeit zusätzlich Autoloader von überall im eigenen
Code zu registrieren wo es notwendig ist.
Das erste Mal wenn eine Instanz des Autoloaders empfangen wird, registriert dieser sich
mit spl_autoload
. Man kann eine Instanz erhalten indem die
getInstance()
Methode verwendet wird:
$autoloader = Zend_Loader_Autoloader::getInstance();
Standardmäßig ist der Autloader so konfiguriert das er den "Zend_" und "ZendX_"
Namespaces entspricht. Wenn man seinen eigenen Bibliothekscode hat der seinen eigenen
Namespace verwendet, kann man Ihn mit dem Autoloader registrieren indem die
registerNamespace()
Methode verwendet. Wenn der eigene
Blbliothekscode ein Präfix von "My_" hat, könnte man auch folgendes tun:
$autoloader->registerNamespace('My_');
Namespace Präfixe
Man sollte beachten dass das vorhergehende Beispiel "My_" verwendet und nicht "My".
Der Grund ist, das Zend_Loader_Autoloader
als Autoloader für
generelle Anwendungsfälle gedacht ist, und deshalb nicht die Annahme macht das ein
angegebener Präfix eines Klassen Namespaces einen Unterstrich enthalten muß. Wenn
der eigene Klassennamespace einen enhält, dann sollte man Ihn
mit dem eigenen Namespace registrieren.
Man kann auch einen eigene Autoloader Callbacks registrieren, optional mit einem
spezifischen Namespace (oder einer Gruppe von Namespaces).
Zend_Loader_Autoloader
versucht zuerst die passenden zu finden
bevor sein interner Autoloading Mechanismus verwendet wird.
Man könnte, als Beispiel, ein oder mehrere eZcomponents Komponenten mit der eigenen
Zend Framework Anwendung verwenden wollen. Um deren Autoloading Möglichkeiten zu
verwenden, müssen diese auf den Autoloader Stack gepusht werden indem man
pushAutoloader()
verwendet:
$autoloader->pushAutoloader(array('ezcBase', 'autoload'), 'ezc');
Das zeigt dem Autoloader das der eZcomponents Autoloader für Klassen zu verwenden ist die mit "ezc" anfangen.
Man kann die unshiftAutoloader()
Methode verwenden um den
Autoloader an den Anfang der Autoloader Kette hinzu zu fügen.
Standmäßig, macht Zend_Loader_Autoloader
keine
Fehlerunterdrückung wenn sein interner Autoloader verwendet wird, der seinerseits
Zend_Loader::loadClass()
verwendet. Die meiste Zeit ist das
genau das was man will. Trotzdem, gibt es Fälle in denen man Sie unterdrücken will.
Man das mit Hilfe von suppressNotFoundWarnings()
tun:
$autoloader->suppressNotFoundWarnings(true);
Letztendlich kann es Zeiten geben in denen man will das der Autoloader irgendeinen
Namespace verwendet. Zum Beispiel verwenden die PEAR Bibliotheken keinen gemeinsamen
Namespace, was es schwierig macht individuelle Namespaces zu spezifizieren wenn viele
PEAR Komponenten verwendet werden. Man kann die
setFallbackAutoloader()
Methode verwenden damit der Autoloader
als catch-all arbeitet:
$autoloader->setFallbackAutoloader(true);
Klassen von PHP Namespaces laden
Beginnend mit Version 1.10.0 erlaubt Zend Framework das Laden von Klassen aus PHP Namespaces. Diese Unterstützung folgt den gleichen Richtlinien und Implementationen wie Sie in der PHP Framework Interop Group PSR-0 Referenz Implementation gefunden werden können.
Mit dieser Richtlinie werden die folgenden Regeln angewandt:
-
Jeder Separator für Namespaces wird zu einem
DIRECTORY_SEPARATOR
konvertiert wenn er vom Dateisystem geladen wird. -
Jedes "_" Zeichen im CLASS NAME wird zu einem
DIRECTORY_SEPARATOR
konvertiert. Das "_" Zeichen hat keine spezielle Bedeutung im Namespace. -
Dem voll-qualifizierte Namespace und der Klasse wird ".php" angehängt wenn Sie vom Dateisystem geladen werden.
Als Beispiel:
-
\Doctrine\Common\IsolatedClassLoader
=>/path/to/project/lib/vendor/Doctrine/Common/IsolatedClassLoader.php
-
\namespace\package\Class_Name
=>/path/to/project/lib/vendor/namespace/package/Class/Name.php
-
\namespace\package_name\Class_Name
=>/path/to/project/lib/vendor/namespace/package_name/Class/Name.php
Typischerweise, verwendet man die Version des Zend Frameworks die mit dem Autoloader,
den man instanziert, gekommen ist. Trotzdem ist es oft nützlich, wenn man ein Projekt
entwickelt, spezielle Versionen zu verwenden, Major und Minor Branches, oder einfach
die letzte Version. Zend_Loader_Autoloader
bietet, seit Version
1.10, einige Features um bei dieser Arbeit zu helfen.
Nehmen wir das folgende Szenario an:
-
Wärend der Entwicklung will man die letzte Version vom Zend Framework verwenden die man installiert hat, damit man sicherstellen kann das die Anwendung funktioniert wenn man zwischen Versionen hochrüstet.
Wenn man auf die Qualitäts-Sicherung wechselt, benötigt man etwas mehr Stabilität, sodas man die letzte installierte Revision einer speziellen Minor Version verwenden will.
Letztendlich, wenn man auf die Produktion wechselt, will man auf eine spezielle installierte Version festnageln, um sicherzustellen das kein Bruch stattfinden wenn man neue Versionen des Zend Frameworks auf dem eigenen Server hinzufügt.
Der Autoloader erlaubt es das mit der Methode setZfPath()
zu
tun. Diese Methode nimmt zwei Argumente, ein Pfad zu einem Set
von Zend Framework Installationen, und eine Version die zu
Verwenden ist. Sobald ausgeführt, wird dem include_path
ein Pfad
vorangestellt der auf die entsprechende Zend Framework Installationsbibliothek zeigt.
Das Verzeichnis das man als den eigenen Pfad spezifiziert sollte einen Pfad wie den folgenden haben:
ZendFramework/ |-- 1.9.2/ | |-- library/ |-- ZendFramework-1.9.1-minimal/ | |-- library/ |-- 1.8.4PL1/ | |-- library/ |-- 1.8.4/ | |-- library/ |-- ZendFramework-1.8.3/ | |-- library/ |-- 1.7.8/ | |-- library/ |-- 1.7.7/ | |-- library/ |-- 1.7.6/ | |-- library/
(wobei Pfad auf das Verzeichnis "ZendFramework" im obigen Beispiel zeigt)
Es ist zu beachten das jedes Unterverzeichnis das Verzeichnis
library
enthalten sollte, welche den aktuellen Zend Framework
Bibliothekscode enthält. Die individuellen Namen der Unterverzeichnisse können
Versionsnummern sein, oder einfach die entpackten Inhalte des standardmäßigen Zend
Framework Distributions Tarballs/Zipfiles.
Sehen wir uns also einige Anwendungsfälle an. Im ersten Anwendungsfall, der Entwicklung, wollen wir die letzte Quellinstallation verwenden. Das kann getan werden indem man "latest" als Version übergibt:
$autoloader->setZfPath($path, 'latest');
Im obigen Beispiel, verweist dass auf das Verzeichnis
ZendFramework/1.9.2/library/
; das kann geprüft werden indem man
den Rückgabewert von getZfPath()
prüft.
In der zweiten Situation, der Qualitäts-Sicherung, wollen wir auf die Minor Release 1.8 verweisen, und die letzte Installation verwenden die wir für diese Release haben. Man kann das wie folgt durchführen:
$autoloader->setZfPath($path, '1.8');
In diesem Fall wird das Verzeichnis ZendFramework/1.8.4PL1/library/
gefunden.
Im letzten Fall, für die Produktion, wollen wir uns auf eine spezielle Version festnageln -- 1.7.7, da dass vorhanden war als die Qualitäts Sicherung getestet hat, also vor unserem eigenen Release.
$autoloader->setZfPath($path, '1.7.7');
Logischerweise wird das Verzeichnis ZendFramework/1.7.7/library/
gefunden.
Man diese Werte auch in der Konfigurationsdatei spezifizieren die man mit
Zend_Application
verwendet. Um das zu tun, muss man die folgenden
Informationen spezifizieren:
[production] autoloaderZfPath = "path/to/ZendFramework" autoloaderZfVersion = "1.7.7" [qa] autoloaderZfVersion = "1.8" [development] autoloaderZfVersion = "latest"
Die unterschiedlichen Umgebungssektionen sind zu beachten, und die verschiedenen
Versionen die in jeder Umgebung spezifiziert werden; diese Faktoren erlauben
Zend_Application
den Autoloader entsprechend zu konfigurieren.
Implikationen für die Geschwindigkeit
Für die beste Performance, sollte man dieses Feature entweder nicht verwenden, oder eine spezielle Zend Framework Version spezifizieren (z.B. nicht "latest", eine Major Revision wie "1", oder eine Minor Revision wie "1.8"). Andernfalls muss der Autoloader die angebotenen Pfade nach Verzeichnissen suchen welche diesem Kriterium entsprechen -- manchmal eine teure Operation die für jede Anfrage durchgeführt wird.
Neben der Möglichkeit eigene Callbacks als Autoloader zu spezifizieren, definiert
Zend Framework auch ein Interface für Autoloading Klassen,
Zend_Loader_Autoloader_Interface
, das implementiert werden kann:
interface Zend_Loader_Autoloader_Interface { public function autoload($class); }
Wenn das Interface verwendet wird, kann man einfach eine Klasseninstanz an
Zend_Loader_Autoloader
's
pushAutoloader()
und
unshiftAutoloader()
Methoden übergeben:
// Angenommen Foo_Autoloader implementiert Zend_Loader_Autoloader_Interface: $foo = new Foo_Autoloader(); $autoloader->pushAutoloader($foo, 'Foo_');
Anbei kann ein Wegweiser für die Methoden gefunden werden die in
Zend_Loader_Autoloader
vorhanden sind.
Tabelle 99. Zend_Loader_Autoloader Methoden
Methode | Rückgabewert | Parameter | Beschreibung |
---|---|---|---|
getInstance() |
Zend_Loader_Autoloader |
N/A |
empfängt die Singleton Instanz von
|
resetInstance() |
void |
N/A |
Setzt den Status der Singleton Instanz von
|
autoload($class) |
string| |
|
Versucht einen Klassennamen zu einer Datei aufzulösen und diese zu laden. |
setDefaultAutoloader($callback) |
Zend_Loader_Autoloader |
|
Spezifiziert einen alternativen PHP Callback der für die standardmäßige Autoloader Implementation verwendet werden soll. |
getDefaultAutoloader() |
callback |
N/A |
Empfängt die standardmäßige Autoloader Implementation; standardmäßig
ist das |
setAutoloaders(array $autoloaders) |
Zend_Loader_Autoloader |
|
Setzt eine Liste von konkreten Autoloadern für deren Verwendung in den Autoloader Stack. Jedes Element im Autoloader Array muß ein PHP Callback sein. |
getAutoloaders() |
Array | N/A | Empfängt den internen Autoloader Stack. |
getNamespaceAutoloaders($namespace) |
Array |
|
Holt alle Autoloader die registriert wurden um mit einem spezifischen Namespace geladen zu werden. |
registerNamespace($namespace) |
Zend_Loader_Autoloader |
|
Registriert ein oder mehrere Namespaces mit dem standardmäßigen
Autoloader. Wenn |
unregisterNamespace($namespace) |
Zend_Loader_Autoloader |
|
De-Registriert ein oder mehrere Namespaces vom standardmäßigen
Autoloader. Wenn |
getRegisteredNamespaces() |
Array | N/A |
Gibt ein Array aller Namespaces zurück die mit dem standardmäßigen Autoloader registriert sind. |
suppressNotFoundWarnings($flag = null)
|
boolean|Zend_Loader_Autoloader |
|
Setzt oder Empfängt den Wert des Flags das verwendet wird um
anzuzeigen ob die standardmäßige Autoloader Implementation "file not
found" Warnungen unterdrücken soll oder nicht. Wenn keine Argumente
oder ein |
setFallbackAutoloader($flag) |
Zend_Loader_Autoloader |
|
Setzt den Wert des Flags das verwendet wird um anzuzeigen ob der standardmäßige Autoloader als Fallback, oder Catch-All Autoloader für alle Namespaces verwendet werden soll. |
isFallbackAutoloader() |
Boolean | N/A |
Empfängt den Wert des Flags das verwendet wird um anzuzeigen ob der
standardmäßige Autoloader als Fallback, oder Catch-All Autoloader
für alle Namespaces verwendet wird. Standardmäßig ist er
|
getClassAutoloaders($class) |
Array |
|
Gibt eine Liste von Namespaced Autoloadern zurück die der angegebenen Klasse potentiell entsprechen. Wenn keine passt, werden alle globalen (nicht ge-namespaceten Autoloader) zurückgegeben. |
unshiftAutoloader($callback, $namespace = '')
|
Zend_Loader_Autoloader |
|
Fügt eine konkrete Autoloader Implementation an den Anfang des Autoloader Stacks hinzu. Wenn ein Namespace angegeben wird, wird dieser Namespace verwendet um optimistischerweise zu passen; andernfalls wird angenommen das der Autoloader ein globaler Autoloader ist. |
pushAutoloader($callback, $namespace = '')
|
Zend_Loader_Autoloader |
|
Fügt eine konkrete Autoloader Implementation an das Ende des internen Autoloader Stacks hinzu. Wenn ein Namespace angegeben wird, wird dieser Namespace verwendet um optimistischerweise zu passen; andernfalls wird angenommen das der Autoloader ein globaler Autoloader ist. |
removeAutoloader($callback, $namespace = '')
|
Zend_Loader_Autoloader |
|
Entfernt eine konkrete Autoloader Implementation vom internen Autoloader Stack. Wenn ein Namespace oder mehrere Namespaces angegeben werden, wird der Callback nur vom angegebenen Namespace oder den angegebenen Namespaces entfernt. |