Dynamisches Laden von Dateien und Klassen
Die Zend_Loader Klasse enthält Methoden die helfen Dateien dynamisch zu laden.
Zend_Loader vs. require_once()
Die Zend_Loader Methoden werden am Besten verwendet wenn der
Dateiname der Verwendet wird variabel ist. Wenn er zum Beispiel auf einem Parameter
einer Benutzereinfabe oder eines Arguments einer Methode basiert. Wenn
eine Datei oder eine Klasse geladen werden soll deren Name konstant ist,
gibt es keinen Vorteil durch die Verwendung von Zend_Loader
gegenüber traditionellen PHP Funktionen wie
require_once().
Dateien laden
Die statische Methode Zend_Loader::loadFile() lädt eine
PHP Datei. Die geladene Datei kann jeden PHP Code enthalten.
Diese Methode ist ein Wrapper für die PHP Funktion
include().
Diese Methode gibt bei einem Fehler ein boosches false zurück,
zum Beispiel wenn die definierte Datei nicht existiert.
Beispiel der loadFile() Methode
Das $filename Argument definert den Dateinamen der geladen
werden soll, und der keine Verzeichnis Informationen enthalten darf.
Eine Sicherheitsprüfung wird auf $filename
durchgeführt. Das $filename Argument darf nur
Alphanumerische Zeichen enthalten, Bindestriche ("-"), Unterstriche ("_")
oder Punkte ("."). Das $dirs Argument hat keine dieser
Einschränkungen.
Das $dirs Argument definiert das Verzeichnis in welchem
nach der Datei gesucht werden soll. Wenn der Wert NULL ist, wird
nur anhand vom include_path gesucht. Wenn der Wert Zeichenkette
oder ein Array ist, wird das definierte Verzeichnis oder
die Verzeichnisse durchsucht, gefolgt vom include_path.
Das $once Argument ist Boolean. Wenn es TRUE
ist, verwendet Zend_Loader::loadFile() die PHP Funktion
include_once()
für das Laden der Datei, andernfalls wird die PHP Funktion
include()
verwendet.
Klassen laden
Die statische Methode Zend_Loader::loadClass($class, $dirs)
lädt eine PHP Datei und prüft anschließend ob die Klasse existiert.
Beispiel der loadClass() Methode
Die Zeichenkette die die Klasse definiert, wird in einen relativen Pfad
umgewandelt durch die Annahme das Verzeichnisse für das OS mit Unterstrichen
getrennt werden und anfügen von '.php'. Im obigen Beispiel wird für Windows
'Container_Tree' zu 'Container/Tree.php'.
Wenn $dirs eine Zeichenkette oder ein Array ist, durchsucht
Zend_Loader::loadClass() die Verzeichnisse in der
angegebenen Reihenfolge. Die erste passende Datei wird geladen. Wenn die
Datei in den definierten Verzeichnissen $dirs nicht existiert
wird der include_path der PHP Umgebung durchsucht.
Wenn die Datei nicht gefunden wird, oder die Klasse nach dem Laden nicht
existiert, wirft Zend_Loader::loadClass() eine
Zend_Exception.
Zend_Loader::loadFile() wird für das Laden verwendet, deswegen
darf der Klassenname nur Alphanumerische Zeichen, den Bindestrich ('-'),
den Unterstrich ('_') und den Punkt ('.') enthalten.
Testen ob eine Datei gelesen werden kann
Die statische Methode Zend_Loader::isReadable($pathname)
gibt TRUE zurück wenn eine Datei im angegebenen Pfadnamen
existiert und lesbar ist, andernfalls FALSE.
Beispiel der isReadable() Methode
Das $filename Argument definiert den Dateinamen der
geprüft werden soll. Er darf Pfadinformationen enthalten. Diese Methode
ist ein Wrapper für die PHP Funktion
is_readable().
Diese PHP Funktion durchsucht den include_path nicht, wärend
Zend_Loader::isReadable() dies macht.
Verwenden von Autoloaders
Die Zend_Loader Klasse enthält eine Methode die im PHP SPL
Autoloader registriert werden kann. Zend_Loader::autoload() ist
die Callback Methode. Als Vereinfachung bietet Zend_Loader die
registerAutoload() Funktion welche die
autoload() Methode registriert. Wenn die
spl_autoload Erweiterung in der PHP Umgebung nicht
vorhanden ist wird die registerAutoload() Methode eine
Zend_Exception werfen.
Beispiel für das registrieren der Autoloader Callback Methode
Nach dem registrieren des Zend Framework Autoload Callbacks, können
die Klassen des Zend Frameworks referenziert werden ohne das sie
explizit geladen werden müssen. Die autoload() Methode
verwendet automatisch Zend_Loader::loadClass() wenn eine
Klasse referenziert wird.
Wenn die Zend_Loader Klasse erweitert wird, kann ein optionales
Argument für registerAutoload() angegeben werden, um die Klasse zu
definieren von welcher die autoload() Methode registriert
werden soll.
Beispiel für das registrieren der Autoload Callback Methode von einer
erweiterten Klasse
Wegen der Semantik der Referenzen von statischen Funktionen in PHP,
muß Code für beide loadClass() und autoload()
implementiert werden, und autoload() muß self::loadClass()
aufrufen. Wenn die autoload() Methode den Aufruf zu
self::loadClass() an die Elternklasse delegiert, ruft Sie die Methode
des Namens in der Elternklasse und nicht in der Subklasse auf.
Der Callback für den Autoloader kann entfernt werden. Die
registerAutoload() Methode hat ein zweites optionales Argument welches
standardmäßig TRUE ist. Wenn dieses Argument FALSE ist, wird
die Registrierung des Callback des Autoloaders vom SPL Autoload Stack entfernt.