Allow configuration of AdapterPluginManager via config file

docs/book/v3/application-integration/usage-in-a-laminas-mvc-application.md

@@ -39,23 +39,6 @@ return [
 
 The factory `Laminas\Cache\Service\StorageCacheAbstractServiceFactory` uses the configuration, searches for the configuration key `caches` and creates the storage adapters using the discovered configuration.
 
-## Register a storage adapter
-
-To register additional storage adapters, use either application or module configuration (such as `config/autoload/*.global.php` or `module/Application/config/module.config.php`, respectively), and define the configuration key `storage_adapters`.
-
-In this example, the global configuration is used and a separate file is created for the storage adapters configuration.
-Create a configuration file with name like `config/autoload/storage_adapters.global.php` and it will [automatically be included](https://docs.laminas.dev/tutorials/advanced-config/#environment-specific-application-configuration):
-
-```php
-return [
-    'storage_adapters' => [
-        'factories' => [
-            \My\Custom\Adapter::class => \My\Custom\AdapterFactory::class,
-        ],
-    ],
-];
-```
-
 ## Create Controller
 
 [Create a controller class](https://docs.laminas.dev/laminas-mvc/quick-start/#create-a-controller) and inject the cache with the interface for all cache storage adapters via the constructor, e.g. `module/Application/Controller/IndexController.php`:

docs/book/v3/storage/adapter-plugin-manager.md

@@ -0,0 +1,28 @@
+# Adapter Plugin Manager
+
+The `AdapterPluginManager` extends the laminas-servicemanager `AbstractPluginManager`, and has the following behaviors:
+
+- It will only return `Laminas\Cache\Storage\StorageInterface` instances.
+- All services are not shared by default; a new instance will be created each time you call `get()`.
+
+## Factory
+
+`Laminas\Cache\Storage\AdapterPluginManager` is mapped to the factory `Laminas\Cache\Service\StorageAdapterPluginManagerFactory` when wired to the dependency injection container.
+
+The factory will be automatically registered when loading/installing the `Laminas\Cache` module in `laminas-mvc` and/or loading/installing the `ConfigProvider` into a Mezzio application.
+
+Since version 3.11.0, the factory will look for the `config` service, and use the `storage_adapters` configuration key to seed it with additional services.
+This configuration key should map to an array that follows [standard laminas-servicemanager configuration](https://docs.laminas.dev/laminas-servicemanager/configuring-the-service-manager/).
+
+To add your own storage adapter you can add the following configuration:
+
+```php
+// config/autoload/storage_adapters.global.php
+return [
+    'storage_adapters' => [
+        'factories' => [
+            \App\MyCustomStorageAdapter::class => \App\Container\MyCustomStorageAdapterFactory::class,
+        ],
+    ],
+];
+```

docs/bookdown.json

@@ -3,6 +3,7 @@
     "target": "html/",
     "content": [
         "book/laminas.cache.storage.adapter.md",
+        "book/laminas.cache.storage.adapter-plugin-manager.md",
         "book/laminas.cache.storage.capabilities.md",
         "book/laminas.cache.storage.plugin.md",
         "book/laminas.cache.pattern.md",

mkdocs.yml

@@ -6,6 +6,7 @@ nav:
         - Installation: v3/installation.md
         - Storage:
             - Adapters: v3/storage/adapter.md
+            - "Adapter Plugin Manager": v3/storage/adapter-plugin-manager.md
             - Capabilities: v3/storage/capabilities.md
             - Plugins: v3/storage/plugin.md
         - "Cache Patterns":