Class ReflectionBasedAbstractFactory

Reflection-based factory.

To ease development, this factory may be used for classes with type-hinted arguments that resolve to services in the application container; this allows omitting the step of writing a factory for each controller.

You may use it as either an abstract factory:

'service_manager' => [

'abstract_factories' => [
    ReflectionBasedAbstractFactory::class,
],

],

Or as a factory, mapping a class name to it:

'service_manager' => [

'factories' => [
    MyClassWithDependencies::class => ReflectionBasedAbstractFactory::class,
],

],

The latter approach is more explicit, and also more performant.

The factory has the following constraints/features:

• A parameter named $config typehinted as an array will receive the application "config" service (i.e., the merged configuration).
• Parameters type-hinted against array, but not named $config will be injected with an empty array.
• Scalar parameters will result in an exception being thrown, unless a default value is present; if the default is present, that will be used.
• If a service cannot be found for a given typehint, the factory will raise an exception detailing this.
• Some services provided by Laminas components do not have entries based on their class name (for historical reasons); the factory allows defining a map of these class/interface names to the corresponding service name to allow them to resolve.

$options passed to the factory are ignored in all cases, as we cannot make assumptions about which argument(s) they might replace.

Based on the LazyControllerAbstractFactory from laminas-mvc.