Warning: You are browsing the documentation for Symfony 2.8, which is no longer maintained.

Read the updated version of this page for Symfony 5.3 (the current stable version).



The 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 PSR-0 class loader.

The MapClassLoader can be used along with the PSR-0 class loader by configuring and calling the register() method on both.


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.


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.php';

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

$loader = new MapClassLoader($mapping);


This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.