Allow configuration of AdapterPluginManager via config file

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":

src/ConfigProvider.php

@@ -16,6 +16,8 @@
 
 class ConfigProvider
 {
+    public const ADAPTER_PLUGIN_MANAGER_CONFIGURATION_KEY = 'storage_adapters';
+
     /**
      * Return default configuration for laminas-cache.
      *

src/Service/StorageAdapterPluginManagerFactory.php

@@ -1,14 +1,45 @@
 <?php
 
+declare(strict_types=1);
+
 namespace Laminas\Cache\Service;
 
+use Laminas\Cache\ConfigProvider;
 use Laminas\Cache\Storage\AdapterPluginManager;
+use Laminas\ServiceManager\ServiceManager;
 use Psr\Container\ContainerInterface;
 
+use function is_array;
+
+/**
+ * @psalm-import-type ServiceManagerConfiguration from ServiceManager
+ */
 final class StorageAdapterPluginManagerFactory
 {
     public function __invoke(ContainerInterface $container): AdapterPluginManager
     {
-        return new AdapterPluginManager($container);
+        $pluginManager = new AdapterPluginManager($container);
+
+        // If we do not have a config service, nothing more to do
+        if (! $container->has('config')) {
+            return $pluginManager;
+        }
+
+        $config = $container->get('config');
+
+        // If we do not have a configuration, nothing more to do
+        if (
+            ! isset($config[ConfigProvider::ADAPTER_PLUGIN_MANAGER_CONFIGURATION_KEY])
+            || ! is_array($config[ConfigProvider::ADAPTER_PLUGIN_MANAGER_CONFIGURATION_KEY])
+        ) {
+            return $pluginManager;
+        }
+
+        // Wire service configuration
+        /** @var ServiceManagerConfiguration $config */
+        $config = $config[ConfigProvider::ADAPTER_PLUGIN_MANAGER_CONFIGURATION_KEY];
+        $pluginManager->configure($config);
+
+        return $pluginManager;
     }
 }