terminal42/contao-namespace-class-loader

Namespace class loader for Contao Open Source CMS

Namespace Class Loader for Contao 3

This extension implements a valid PSR-0 class loader for Contao 3. The implementation is based on the Composer\Autoload\ClassLoader., _(*1)

This extension is outdated, see the Upgrade information!, _(*2)

Usage

Place all files in system/modules/_autoload in your Contao installation., _(*3)

Usage works similar to the Contao class loader, except that you do not need to include every class file if you follow PSR-0 standards. Use the following example to implement the class loader in your config/autoload.php:, _(*4)

<?php

/**
 * Register namespace
 */
NamespaceClassLoader::add('Isotope', 'system/modules/isotope/library');

Upgrade to Contao 4

In Contao 4, the only way to install extensions is using Composer. Therefore, you will not need this extension but should use Composer's class loader., _(*5)

To be compatible with Contao 3 extension repository and Contao 4, you will need to require at least Contao 3.3 and set it up as follow:, _(*6)

1. Define your namespaces or classes in composer.json.
2. Remove the dependency for terminal42/contao-namespace-class-loader from your composer.json
3. Keep the dependency in the old Extension Repository

4. Make _autoload an optional dependency in your autoload.ini like so:, _(*7)

   requires[] = "*_autoload"

5. Only call NamespaceClassLoader in your autoload.php if the class is actually available:, _(*8)

   if (class_exists('NamespaceClassLoader')) {
       NamespaceClassLoader::add( ... );
   }

If the extension is installed via Composer, the classes will be loaded by the Composer autoloader. When installed using the old extension repository, the _autoload extension will be added and the classes will work like before., _(*9)

See our commit on how we accomplished this in [Isotope eCommerce][3]., _(*10)