La première fois qu'une instance de l'autoloader est créée, il s'enregistre lui-même sur la fonction spl_autoload. Vous récupérez son instance via la méthode getInstance() :

$autoloader = Zend_Loader_Autoloader::getInstance();

Par défaut, l'autoloader est configuré pour capturer les espaces de noms "Zend_" et "ZendX_". Si votre propre librairie de code utilise un espace de noms différent, vous devez alors enregistrer celui-ci avec la méthode registerNamespace(). Par exemple, si votre librairie possède l'espace de noms "My_", vous devriez agir comme cela :

$autoloader->registerNamespace('My_');

Il est aussi possible que vous enregistriez vos propres fonctions d'autoload, optionnellement avec un espace de noms spécifique, Zend_Loader_Autoloader va alors tenter de l'utiliser lorsque nécessaire (lors de l'auto-chargement).

Par exemple, vous pourriez avoir besoin d'un ou plusieurs composants eZcomponents avec votre application Zend Framework. Pour utiliser ses capacités d'autoload, ajoutez son autoloader à votre pile grâce à pushAutoloader() :

$autoloader->pushAutoloader(array('ezcBase', 'autoload'), 'ezc');

Ceci indique que les classes dont le nom commence par "ezc" devra utiliser cette fonction d'autoload.

unshiftAutoloader(), elle, rajoute la méthode d'autoload au début de la pile.

Par défaut, Zend_Loader_Autoloader ne supprime aucune erreur lorsqu'il utilise son autoloader interne, s'appuyant sur Zend_Loader::loadClass(). La plupart du temps, c'est le comportement recherché. Cependant, si vous voulez faire apparaître les éventuelles erreurs de chargement, appelez alors suppressNotFoundWarnings() :

$autoloader->suppressNotFoundWarnings(true);

Enfin, il se peut que vous vouliez que l'autoloader par défaut charge toutes les classes de tous les espaces de noms. Par exemple, les librairies PEAR ne partagent pas un espace de noms commun, ce qui rend la tâche difficile si on veut associer chacun des espaces de noms internes. Utilisez alors setFallbackAutoloader() pour rendre l'autoloader "global" et charger tous les espaces de noms :

$autoloader->setFallbackAutoloader(true);

Typically, you will use the version of Zend Framework that the autoloader you instantiate came with. However, when developing a project, it's often useful to track specific versions, major or minor branches, or just the latest version. Zend_Loader_Autoloader, as of version 1.10, offers some features to help manage this task.

Imagine the following scenario:

The autoloader allows you to do this with the method setZfPath(). This method takes two arguments, a path to a set of Zend Framework installations, and a version to use. Once invoked, it prepends a path to the include_path pointing to the appropriate Zend Framework installation library.

The directory you specify as your path should have a tree such as the following:

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/

(where path points to the directory "ZendFramework" in the above example)

Note that each subdirectory should contain the directory library, which contains the actual Zend Framework library code. The individual subdirectory names may be version numbers, or simply be the untarred contents of a standard Zend Framework distribution tarball/zipfile.

Now, let's address the use cases. In the first use case, in development, we want to track the latest source install. We can do that by passing "latest" as the version:

$autoloader->setZfPath($path, 'latest');

In the example from above, this will map to the directory ZendFramework/1.9.2/library/; you can verify this by checking the return value of getZfPath().

In the second situation, for quality assurance, let's say we want to pin to the 1.8 minor release, using the latest install you have for that release. You can do so as follows:

$autoloader->setZfPath($path, '1.8');

In this case, it will find the directory ZendFramework/1.8.4PL1/library/.

In the final case, for production, we'll pin to a specific version -- 1.7.7, since that was what was available when Quality Assurance tested prior to our release.

$autoloader->setZfPath($path, '1.7.7');

Predictably, it finds the directory ZendFramework/1.7.7/library/.

You can also specify these values in the configuration file you use with Zend_Application. To do so, you'd specify the following information:

[production]
autoloaderZfPath = "path/to/ZendFramework"
autoloaderZfVersion = "1.7.7"

[qa]
autoloaderZfVersion = "1.8"

[development]
autoloaderZfVersion = "latest"

Note the different environment sections, and the different version specified in each environment; these factors will allow Zend_Application to configure the autoloader appropriately.

Vous pouvez donc ajouter des fonctions de chargement par espace de noms, mais Zend Framework définit aussi une interface pour l'autoload, Zend_Loader_Autoloader_Interface :

interface Zend_Loader_Autoloader_Interface
{
    public function autoload($class);
}

L'utilisation de l'interface vous permet de passer un objet aux méthodes pushAutoloader() et unshiftAutoloader() de Zend_Loader_Autoloader :

// Foo_Autoloader implémente Zend_Loader_Autoloader_Interface:
$foo = new Foo_Autoloader();

$autoloader->pushAutoloader($foo, 'Foo_');

Voici un guide des méthodes de Zend_Loader_Autoloader.