map_class_loader.rst

.. index::
    single: ClassLoader; MapClassLoader

MapClassLoader

The :class:`Symfony\\Component\\ClassLoader\\MapClassLoader` allows you to autoload files via a static map from classes to files. This is useful if you use third-party libraries which don't follow the PSR-0 standards and so can't use the :doc:`PSR-0 class loader </components/class_loader/class_loader>`.

The MapClassLoader can be used along with the :doc:`PSR-0 class loader </components/class_loader/class_loader>` by configuring and calling the register() method on both.

Note

The default behavior is to append the MapClassLoader on the autoload stack. If you want to use it as the first autoloader, pass true when calling the register() method. Your class loader will then be prepended on the autoload stack.

Usage

Using it is as easy as passing your mapping to its constructor when creating an instance of the MapClassLoader class:

require_once '/path/to/src/Symfony/Component/ClassLoader/MapClassLoader';

$mapping = array(
    'Foo' => '/path/to/Foo',
    'Bar' => '/path/to/Bar',
);

$loader = new MapClassLoader($mapping);

$loader->register();