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 wirft bei einem Fehler eine Zend_Exception, zum Beispiel wenn die definierte Datei nicht existiert.

<?php

Zend_Loader::loadFile($filename, $dirs=null, $once=false)

?>

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 es NULL ist, wird nur anhand vom include_path gesucht. Wenn eine Zeichenkette oder ein Array angegeben wurde, wird das definierte Verzeichnis oder die Verzeichnisse durchsucht, und anschließend der 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.

Die statische Methode Zend_Loader::loadClass($class, $dirs) lädt eine PHP Datei und prüft anschließend ob die Klasse existiert.

<?php

Zend_Loader::loadClass('Container_Tree',
    array(
        '/home/production/mylib',
        '/home/production/myapp'
    )
);

?>

Die Zeichenkette die die Klasse definiert, wird in einen relativen Pfad umgewandelt durch die Annahme das Verzeichnisse mit Unterstrichen getrennt werden und anfügen von '.php'. Im obigen Beispiel wird '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.

Die statische Methode Zend_Loader::isReadable($pathname) gibt TRUE zurück wenn eine Datei im angegebenen Pfadnamen existiert und lesbar ist, andernfalls FALSE.

<?php

if (Zend_Loader::isReadable($filename)) {
    // Mach was mit $filename
}

?>

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.

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.

<?php

Zend_Loader::registerAutoload();

?>

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.

<?php

class My_Loader extends Zend_Loader
{
    // eigene Funktionalitäten
}

Zend_Loader::registerAutoload('My_Loader');

?>