La primera vez que se recupera una instancia del autoloader, este se registra a sí mismo con spl_autoload. Se recupera una instancia usando el método getInstance():

$autoloader = Zend_Loader_Autoloader::getInstance();

De forma predeterminada, el autoloader está configurado para coincidir con los namespaces "Zend_" y "ZendX_". Si tiene su propio código de librería que utiliza su propio namespace, puede registrarlo con el autoloader usando el método registerNamespace(). Por ejemplo, si el código de su librería tiene el prefijo "My_", podría hacerlo de la siguiente manera:

$autoloader->registerNamespace('My_');

También puede registrar callbacks de autoloader arbitrarios, opcionalmente con un namespace específico (o grupo de namespaces). Zend_Loader_Autoloader intentará hacerlos coincidir primero antes de usar su mecanismo interno de autocarga.

Como ejemplo, puede que desee utilizar uno o más componentes de eZcomponents con su aplicación de Zend Framework. Para usar sus capacidades de autocarga, añádalo a la pila del autoloader usando pushAutoloader():

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

Esto le indica al autoloader que use el autoloader de eZcomponents para las clases que comienzan con "ezc".

Puede usar el método unshiftAutoloader() para añadir el autoloader al principio de la cadena de autoloaders.

De forma predeterminada, Zend_Loader_Autoloader no realiza supresión de errores cuando utiliza su autoloader interno, el cual utiliza Zend_Loader::loadClass(). La mayoría de las veces, esto es exactamente lo que se desea. Sin embargo, puede haber casos en los que se desee suprimirlos. Puede hacerlo usando suppressNotFoundWarnings():

$autoloader->suppressNotFoundWarnings(true);

Finalmente, puede haber ocasiones en las que quiera que el autoloader cargue cualquier namespace. Por ejemplo, las librerías de PEAR no comparten un namespace común, lo que hace que especificar namespaces individuales sea difícil cuando se usan muchos componentes de PEAR. Puede usar el método setFallbackAutoloader() para que el autoloader actúe como un catch-all:

$autoloader->setFallbackAutoloader(true);

Normalmente, usará la versión de Zend Framework con la que vino el autoloader que instancia. Sin embargo, al desarrollar un proyecto, a menudo resulta útil rastrear versiones específicas, ramas mayores o menores, o simplemente la última versión. Zend_Loader_Autoloader, a partir de la versión 1.10, ofrece algunas funciones para ayudar a gestionar esta tarea.

Imagine el siguiente escenario:

El autoloader le permite hacer esto con el método setZfPath(). Este método toma dos argumentos: una ruta a un conjunto de instalaciones de Zend Framework, y una versión a usar. Una vez invocado, antepone una ruta al include_path que apunta a la librería de instalación de Zend Framework correspondiente.

El directorio que especifique como su ruta debe tener un árbol como el siguiente:

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/

(donde ruta apunta al directorio "ZendFramework" en el ejemplo anterior)

Tenga en cuenta que cada subdirectorio debe contener el directorio library, que contiene el código real de la librería de Zend Framework. Los nombres de los subdirectorios individuales pueden ser números de versión, o simplemente el contenido descomprimido de un tarball/zipfile de distribución estándar de Zend Framework.

Ahora, abordemos los casos de uso. En el primer caso de uso, en desarrollo, queremos rastrear la última instalación de código fuente. Podemos hacer eso pasando "latest" como versión:

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

En el ejemplo anterior, esto se asignará al directorio ZendFramework/1.9.2/library/; puede verificar esto comprobando el valor de retorno de getZfPath().

En la segunda situación, para control de calidad, digamos que queremos fijarnos a la versión menor 1.8, usando la última instalación que tengamos para esa versión. Puede hacerlo de la siguiente manera:

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

En este caso, encontrará el directorio ZendFramework/1.8.4PL1/library/.

En el último caso, para producción, nos fijaremos a una versión específica -- 1.7.7, ya que eso era lo disponible cuando Control de Calidad realizó pruebas antes de nuestro lanzamiento.

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

Como era de esperar, encuentra el directorio ZendFramework/1.7.7/library/.

También puede especificar estos valores en el archivo de configuración que utiliza con Zend_Application. Para hacerlo, especificaría la siguiente información:

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

[qa]
autoloaderZfVersion = "1.8"

[development]
autoloaderZfVersion = "latest"

Observe las diferentes secciones de entorno, y la diferente versión especificada en cada entorno; estos factores permitirán que Zend_Application configure el autoloader apropiadamente.

Además de poder especificar callbacks arbitrarios como autoloaders, Zend Framework también define una interfaz que las clases de autocarga pueden implementar, Zend_Loader_Autoloader_Interface:

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

Cuando use esta interfaz, simplemente puede pasar una instancia de clase a los métodos pushAutoloader() y unshiftAutoloader() de Zend_Loader_Autoloader:

// Assume Foo_Autoloader implements Zend_Loader_Autoloader_Interface:
$foo = new Foo_Autoloader();

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

A continuación, encontrará una guía de los métodos disponibles en Zend_Loader_Autoloader.