Drop zend loader, module loader and autoloader provider features.

composer.json

@@ -24,15 +24,13 @@
     "require-dev": {
         "zendframework/zend-console": "^2.6",
         "zendframework/zend-di": "^2.6",
-        "zendframework/zend-loader": "^2.5",
         "zendframework/zend-mvc": "^3.0 || ^2.7",
         "zendframework/zend-servicemanager": "^3.0.3 || ^2.7.5",
         "phpunit/phpunit": "^7.5.16",
         "zendframework/zend-coding-standard": "~1.0.0"
     },
     "suggest": {
         "zendframework/zend-console": "Zend\\Console component",
-        "zendframework/zend-loader": "Zend\\Loader component if you are not using Composer autoloading for your modules",
         "zendframework/zend-mvc": "Zend\\Mvc component",
         "zendframework/zend-servicemanager": "Zend\\ServiceManager component"
     },
@@ -43,8 +41,10 @@
     },
     "autoload-dev": {
         "files": [
-            "test/autoload.php",
-            "test/TestAsset/ModuleAsClass.php"
+            "test/autoload.php"
+        ],
+        "classmap": [
+            "test/TestAsset/"
         ],
         "psr-4": {
             "ListenerTestModule\\": "test/TestAsset/ListenerTestModule/",

docs/book/intro.md

@@ -15,10 +15,6 @@ CSS, and JavaScript. The possibilities are endless.
 
 The module system is made up of the following:
 
-- [The Module Autoloader](https://docs.zendframework.com/zend-loader/module-autoloader/) -
-  `Zend\Loader\ModuleAutoloader` is a specialized autoloader that is responsible
-  for the locating and loading of modules' `Module` classes from a variety of
-  sources.
 - [The Module Manager](module-manager.md) - `Zend\ModuleManager\ModuleManager`
   takes an array of module names and fires a sequence of events for each one,
   allowing the behavior of the module system to be defined entirely by the
@@ -34,47 +30,31 @@ The module system is made up of the following:
 > [PHP namespace](http://php.net/namespaces), and must follow all of the same
 > rules for naming.
 
-The recommended structure for an MVC-oriented ZF2 module is as follows:
+The recommended structure for a zend-mvc oriented module is as follows:
 
 ```text
 module_root/
-    Module.php
-    autoload_classmap.php
-    autoload_function.php
-    autoload_register.php
     config/
         module.config.php
     public/
         images/
         css/
         js/
     src/
-        <module_namespace>/
-            <code files>
+        Module.php
+        <code files as per PSR-4>
     test/
-        phpunit.xml
-        bootstrap.php
-        <module_namespace>/
-            <test code files>
+        <test code files>
     view/
         <dir-named-after-module-namespace>/
             <dir-named-after-a-controller>/
                 <.phtml files>
+    phpunit.xml.dist
+    composer.json
 ```
 
-## The autoload\_\*.php Files
+## Autoloading
 
-The three `autoload_*.php` files are not required, but recommended. They provide the following:
-
-- `autoload_classmap.php` should return an array classmap of class name/filename
-  pairs (with the filenames resolved via the `__DIR__` magic constant).
-- `autoload_function.php` should return a PHP callback that can be passed to
-  `spl_autoload_register()`. Typically, this callback should utilize the map
-  returned by `autoload_classmap.php`.
-- `autoload_register.php` should register a PHP callback (typically that
-  returned by `autoload_function.php` with `spl_autoload_register()`.
-
-The purpose of these three files is to provide reasonable default mechanisms for
-autoloading the classes contained in the module, thus providing a trivial way to
-consume the module without requiring zend-modulemanager` (e.g., for use outside
-a ZF2 application).
+Since version 3, zend-modulemanager does not provide own autoloading mechanisms
+and instead relies on [Composer dependency manager](https://getcomposer.org/)
+to provide autoloading.

docs/book/migration/to-v3-0.md

@@ -0,0 +1,84 @@
+# Upgrading to 3.0
+
+## Module autoloading
+
+zend-modulemanager originates from before the Composer was created, where each
+framework had to provide its own autoloading implementation.
+Since then Composer became the de-facto standard in managing dependencies and
+autoloading for the php projects.  
+In light of that, zend-servicemanager removes ModuleLoader and autoload
+providers support in version 3.0 in favor of
+[Composer dependency manager](https://getcomposer.org/).
+
+### Application local modules
+
+Autoloading rules for application local modules should now be defined in
+application's composer.json
+
+Before:
+```php
+namespace Application;
+
+class Module
+{
+    public function getAutoloaderConfig()
+    {
+        return [
+            'Zend\Loader\StandardAutoloader' => [
+                'namespaces' => [
+                    __NAMESPACE__ => __DIR__ . '/src/' . __NAMESPACE__,
+                ],
+            ],
+        ];
+    }
+}
+```
+and after:
+```json
+{
+    "name": "zendframework/skeleton-application",
+    "description": "Skeleton Application for Zend Framework zend-mvc applications",
+    "type": "project",
+    ...
+    "autoload": {
+        "psr-4": {
+            "Application\\": "module/Application/src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "ApplicationTest\\": "module/Application/test/"
+        }
+    }
+}
+```
+
+[zf-composer-autoloading](https://github.com/zfcampus/zf-composer-autoloading)
+provides a handy tool to easily add and remove autoloading rules for local modules to
+application's composer.json
+
+After autoloading rules were updated, composer will need to update autoloader:
+
+```console
+$ composer dump-autoload
+```
+
+### Composer installed modules
+
+For composer installed modules, autoloading rules will be automatically picked
+by composer from the module's composer.json and no extra effort is needed:
+```json
+{
+    "name": "acme/my-module",
+    "description": "Module for use with zend-mvc applications.",
+    "type": "library",
+    "require": {
+        "php": "^7.1"
+    },
+    "autoload": {
+        "psr-4": {
+            "Acme\\MyModule\\": "src/"
+        }
+    }
+}
+```