All 7 Namespaces & Autoloading questions
More in Namespaces & Autoloading
How do you use the use keyword to import a class from a specific namespace, letting you reference it by its short name within a file? How does PSR-4 autoloading work, and how does it map a namespace structure directly to a corresponding directory structure on disk? What is the difference between using a relative namespace reference, a fully qualified name starting with a backslash, and importing a class with use, when referencing a class from within a namespaced file? How do you organize namespaces effectively in a larger application to reflect logical groupings such as models, services, and controllers? How does Composer generate and optimize its autoloader for production, and what is the difference between the development autoloader and an optimized production autoloader?
Advertisement
PHP › Namespaces & Autoloading

How does Composer's classmap and files autoloading mechanism differ from PSR-4, and when would you use these alternative approaches instead?

Advanced

Answer

Classmap autoloading builds a direct map of every specific class to its exact file location by scanning specified directories, which is useful for legacy code that does not follow a consistent namespace and directory structure convention like PSR-4 requires, while files autoloading simply ensures specific files, often containing global helper functions rather than classes, are always automatically included on every request, both providing flexibility for situations that do not neatly fit the PSR-4 convention.
{
  "autoload": {
    "classmap": ["legacy/"],
    "files": ["src/helpers.php"]
  }
}
Real-world example A project incorporating an older legacy codebase that does not follow PSR-4 conventions uses classmap autoloading specifically for that legacy directory, while still using standard PSR-4 for all of its newer, properly organized code.

Common follow-ups: What is the performance tradeoff between classmap and PSR-4 autoloading?;Why is using files autoloading for global helper functions sometimes considered less ideal than a proper class based approach?

Composer;Package Development & Publishing with Composer
All 7 Namespaces & Autoloading questions