Download the PHP package phly/phly-expressive-configfactory without Composer
On this page you can find all versions of the php package phly/phly-expressive-configfactory. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download phly/phly-expressive-configfactory
More information about phly/phly-expressive-configfactory
Files in phly/phly-expressive-configfactory
Package phly-expressive-configfactory
Short Description Factory for pulling nested configuration arrays from the config service
License BSD-3-Clause
Informations about the package phly-expressive-configfactory
phly-expressive-configfactory
Abandoned
This package is abandoned as of 2020-01-14. Users are encouraged to migrate to Laminas and to use phly/phly-configfactory as a replacement for this package.
This library provides a re-usable factory for pulling configuration from nested keys.
Installation
Run the following to install this library:
Usage
Assign the factory Phly\Expressive\ConfigFactory
to services named with the
following structure:
As an example, if you have the following structure:
and you wanted the "blog" adapter configuration, you would assign the dependency as follows:
Return empty or raise exception
By default, if no configuration at the expected key is found, the factory returns an empty array. If you want it to instead raise an exception, you can assign the factory as follows:
This operation is safe, as
ConfigFactory
implements__set_state()
, allowing it to be serialized safely withvar_export()
.
The exception will indicate the key hierarchy it was attempting to retrieve.
Using configuration in factories
In your factories, you will refer to the metaname when retrieving the service. Following our example above:
Abstract Factory
Since 1.1.0
If you are using zend-servicemanager,
you can use the class Phly\Expressive\ConfigAbstractFactory
as an abstract
factory. This allows you to omit adding a factory entry for every configuration
segment you want to retrieve. Instead, you can add the following:
When present, it will handle any services with the prefix config-
, and operate
in the same way as the ConfigFactory
.
Caveats
You should only specify keys that will return an array. Most containers only
allow returning an array or object from factories, and will raise an exception
otherwise. For those requiring an object, Expressive generally casts to an
ArrayObject
instance, making this safe.