Feature: Add the AutoLoad utility class

Author: michaeluno

README.md

@@ -70,7 +70,7 @@ This parameter accepts an array holding options.
 
  - `output_buffer`		: (boolean)	whether output buffer should be printed.     
  - `exclude_classes` 	: (array)   an array holding class names to exclude.
- - `base_dir_var`		: (string)	the variable or constant name that is prefixed before the inclusion path.
+ - `base_dir_var`		: (string)	the variable or constant name that is prefixed before the inclusion path. Default: `__DIR__`.
  - `output_var_name`	: (string)  the variable string that the map array is assigned to. Default: `$aClassMap`. If `return` is set, the variable will not be set but the file just returns the generated map array. 
  - `do_in_constructor`  : (boolean) whether to perform the action in the constructor. Default: `true`.
  - `structure`          : (string) either `CLASS` or `PATH`. When `CLASS` is set, the generated array keys consist of class names. When `PATH` is set, the generated array keys consist of paths. Default: `CLASS`.
@@ -143,5 +143,23 @@ print_r( $_oGenerator->get() );
 ```
 To find JavaScript files, change the `'css'` part to `'js'` in the `allowed_extensions` search argument.
 
+## Bundled Utility Autoloader
+This package includes an autoloader.
+
+### Examples
+#### Including an array of class list
+```
+$_aClassMap = [
+  "PHPClassMapGenerator\\PHPClassMapGenerator" => __DIR__ . "/PHPClassMapGenerator.php",
+  "PHPClassMapGenerator\\Autoload" => __DIR__ . "/autoload.php",
+];
+PHPClassMapGenerator\Utility\Autoload::set( $_aClassMap );
+```
+
+#### Including the class map file that returns an array of class list
+```
+PHPClassMapGenerator\Utility\Autoload::set( include( __DIR__ . '/class-map.php' ) );
+```
+
  ## License
  Licensed under [MIT](./LICENSE).

source/Utility/AutoLoad.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace PHPClassMapGenerator\Utility;
+
+/**
+ *
+ * ### Examples
+ * #### Including an array of class list
+ * ```
+ * $_aClassMap = [
+ *   "PHPClassMapGenerator\\PHPClassMapGenerator" => __DIR__ . "/PHPClassMapGenerator.php",
+ *   "PHPClassMapGenerator\\Autoload" => __DIR__ . "/autoload.php",
+ * ];
+ * PHPClassMapGenerator\Utility\Autoload::set( $_aClassMap );
+ * ```
+ * #### Including the class map file that returns an array of class list
+ * ```
+ * PHPClassMapGenerator\Utility\Autoload::set( include( __DIR__ . '/class-map.php' ) );
+ * ```
+ * @since 1.3.0
+ */
+class AutoLoad {
+
+    public $aClasses = [];
+
+    /**
+     * @param array $aClasses
+     */
+    public function __construct( array $aClasses ) {
+        $this->aClasses = $aClasses;
+        spl_autoload_register( array( $this, 'replyToIncludeClass' ), false );
+    }
+
+    /**
+     * @param    string                  $sUnknownClassName
+     * @callback sql_autoload_register()
+     */
+    public function replyToIncludeClass( $sUnknownClassName ) {
+        if ( ! isset( $this->aClasses[ $sUnknownClassName ] ) ) {
+            return;
+        }
+        include( $this->aClasses[ $sUnknownClassName ] );
+    }
+
+    /**
+     * @param array $aClasses
+     */
+    static public function set( array $aClasses ) {
+        $_sSelfClass = __CLASS__;
+        new $_sSelfClass( $aClasses );
+    }
+
+}

source/autoload.php

@@ -2,18 +2,5 @@
 
 namespace PHPClassMapGenerator;
 
-Autoload::set( include( __DIR__ . '/class-map.php' ) );
-
-class Autoload {
-    static public function set( array $aClasses ) {
-        self::$aAutoLoadClasses = $aClasses + self::$aAutoLoadClasses;
-        spl_autoload_register( array( __CLASS__, 'replyToIncludeClass' ), false );
-    }
-    static public function replyToIncludeClass( $sUnknownClassName ) {
-        if ( ! isset( self::$aAutoLoadClasses[ $sUnknownClassName ] ) ) {
-            return;
-        }
-        include( self::$aAutoLoadClasses[ $sUnknownClassName ] );
-    }
-    static public $aAutoLoadClasses = [];
-}
+include_once( __DIR__ . '/Utility/AutoLoad.php' );
+Utility\Autoload::set( include( __DIR__ . '/class-map.php' ) );

source/class-map.php

@@ -7,11 +7,11 @@
  */
 return array(
     "PHPClassMapGenerator\\PHPClassMapGenerator" => __DIR__ . "/PHPClassMapGenerator.php", 
-    "PHPClassMapGenerator\\Autoload" => __DIR__ . "/autoload.php", 
     "PHPClassMapGenerator\\interfacePHPClassMapGenerator" => __DIR__ . "/interfacePHPClassMapGenerator.php", 
     "PHPClassMapGenerator\\FileSystem\\FileListGenerator" => __DIR__ . "/FileSystem/FileListGenerator.php", 
     "PHPClassMapGenerator\\FileSystem\\traitFileSearch" => __DIR__ . "/FileSystem/traitFileSearch.php", 
     "PHPClassMapGenerator\\Header\\HeaderGenerator" => __DIR__ . "/Header/HeaderGenerator.php", 
+    "PHPClassMapGenerator\\Utility\\AutoLoad" => __DIR__ . "/Utility/AutoLoad.php", 
     "PHPClassMapGenerator\\Utility\\traitCodeParser" => __DIR__ . "/Utility/traitCodeParser.php", 
     "PHPClassMapGenerator\\Utility\\traitPath" => __DIR__ . "/Utility/traitPath.php", 
 );