Download the PHP package mikemix/mxdi-module without Composer
On this page you can find all versions of the php package mikemix/mxdi-module. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download mikemix/mxdi-module
More information about mikemix/mxdi-module
Files in mikemix/mxdi-module
Package mxdi-module
Short Description Configure dependency injection in ZF2 using annotations/YAML
License MIT
Homepage https://github.com/mikemix/mxdiModule
Informations about the package mxdi-module
mxdiModule
Configure dependency injection in Zend Framework 2 using annotations/yaml/xml.
Idea based on the JMSDiExtraBundle for the Symfony2 project.
- Installation
- Changing mapping driver
- Important notes
- Caching
- Debugging
- Console commands
Installation
-
Install with Composer:
composer require mikemix/mxdi-module:~3.0
(rules of semantic versioning apply). -
Enable the module via ZF2 config in
appliation.config.php
undermodules
key:This will enable the module and register the Abstract Factory in the ZF2's Service Manager.
-
Copy the global config file
cp vendor/mikemix/mxdi-module/resources/mxdimodule.global.php.dist config/autoload/mxdimodule.global.php
if you want to override the default mapping driver. - Copy the local config file
cp vendor/mikemix/mxdi-module/resources/mxdimodule.local.php.dist config/autoload/mxdimodule.local.php
if you want to override other settings, like caching etc.
Changing mapping driver
The default mapping driver is AnnotationExtractor
as source of mapping information for the module. You can change it however to other. Available extractors are:
AnnotationExtractor
(default) which uses annotations inside your classes. See the Annotation docs for annotations reference and examples.YamlExtractor
which uses a yml file. See the YAML docs for examples.XmlExtractor
which uses a xml file. See the XML docs for examples.
There's no difference between choosing annotation driver or YAML or XML driver, because the mapping information in the end is converted to plain php and stored inside the cache.
Important notes
Remember, the requested service must not be registered in the Service Manager. If you register it as factory or invokable, it won't go through the Abstract Factory and won't get injected. By the way, this allows you to create custom factory for the service in mention.
To speed up locate time you can request the service through the DiFactory invokable, for example:
Caching
Parsing mapping sources is very heavy. You should enable the cache on production servers.
You can set up caching easily with any custom or pre-existing ZF2 cache adapter. In the config/autoload/mxdimodule.local.php
override the cache_adapter
and cache_options
keys for your needs. You can find more information about available out-of-the-box adapters at the ZF2 docs site.
Debugging
If you get ServiceNotCreated exception most probably one of your injections is not registered in the ZF2's Service Manager. In the exception stack you will see some more detailed information. For instance look for CannotGetValue exceptions.
Console commands
-
Clear generated proxy files:
php public/index.php mxdimodule proxy clear
Clear all generated proxy files from the proxy dir
-
Clear annotation parsing cache:
php public/index.php mxdimodule cache clear [<fqcn>]
Flush whole cache or only of a given service
All versions of mxdi-module with dependencies
doctrine/annotations Version ~1.2.4
symfony/yaml Version ~2.7.1
zendframework/zend-servicemanager Version ~2.5
zendframework/zend-modulemanager Version ~2.5
zendframework/zend-mvc Version ~2.5
zendframework/zend-cache Version ~2.5
zendframework/zend-console Version ~2.5
ocramius/proxy-manager Version ~1.0.0