Download the PHP package wikimedia/object-factory without Composer
On this page you can find all versions of the php package wikimedia/object-factory. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download wikimedia/object-factory
More information about wikimedia/object-factory
Files in wikimedia/object-factory
Package object-factory
Short Description Construct objects from configuration instructions
License GPL-2.0-or-later
Homepage https://www.mediawiki.org/wiki/ObjectFactory
Informations about the package object-factory
Wikimedia ObjectFactory
Construct objects from configuration instructions.
It can be used statically, or as a service wrapping a PSR-11 service container for lazy instantiation of objects with dependency injection.
Specification array
Contents of the specification array are as follows:
'factory' => callable,
'class' => string,
The specification array must contain either a 'class' key with string value that specifies the class name to instantiate or a 'factory' key with a callable (is_callable() === true). If both are passed, 'factory' takes precedence but an InvalidArgumentException will be thrown if the resulting object is not an instance of the named class.
'args' => array,
'closure_expansion' => bool, // default true
'spec_is_arg' => bool, // default false
'services' => (string|null)[], // default empty
'optional_services' => (string|null)[], // default empty
The 'args' key, if provided, specifies arguments to pass to the constructor/callable. Values in 'args' which are Closure instances will be expanded by invoking them with no arguments before passing the resulting value on to the constructor/callable. This can be used to pass live objects to the constructor/callable. This behavior can be suppressed by adding closure_expansion => false to the specification.
If 'spec_is_arg' => true is in the specification, 'args' is ignored. The entire spec array is passed to the constructor/callable instead.
If 'services' is supplied and non-empty (and a service container is available),
the named services are requested from the PSR-11 service container and
prepended before 'args'. null
values in 'services' are passed to the constructor
unchanged.
Optional services declared via 'optional_services' are handled the same,
except that if the service is not available from the service container
null
is passed as a parameter instead. Optional services are appended
directly after the normal required services
If any extra arguments are passed in the options to getObjectFromSpec() or
createObject(), these are prepended before the 'services' and 'args'.
These are passed using the extraArgs
key, and any Closure instances that
are included this way are never expanded, regardless of whether the main
argument list is expanded.
'calls' => array
The specification may also contain a 'calls' key that describes method calls to make on the newly created object before returning it. This pattern is often known as "setter injection". The value of this key is expected to be an associative array with method names as keys and argument lists as values. The argument list will be expanded (or not) in the same way as the 'args' key for the main object.
Note these calls are not passed the extra arguments.
Installation
Usage
License
Wikimedia ObjectFactory is licensed under the GNU General Public License,
version 2 and any later version (GPL-2.0-or-later). See the
COPYING
file for more details.