radnan/rdn-factory

Zend Framework 2 module to help create factory classes

RdnFactory

The RdnFactory ZF2 module makes it really easy to create factory classes., _(*1)

How to install

1. Use composer to require the radnan/rdn-factory package:, _(*2)

   $ composer require radnan/rdn-factory:1.*
   

2. Activate the module by including it in your application.config.php file:, _(*3)

   <?php
   
   return array(
      'modules' => array(
          'RdnFactory',
          // ...
      ),
   );
   

How to use

The module provides an RdnFactory\AbstractFactory class that you should extend when creating your factory classes. Implement the protected create() method to create your service., _(*4)

namespace FooModule\Factory\Controller;

use FooModule\Controller;
use RdnFactory\AbstractFactory;

class Bar extends AbstractFactory
{
    protected function create()
    {
        // Create and return your service
        return new Controller\Bar;
    }
}

This abstract factory has access to a repository of plugins, similar to a controller. Simply call the plugin as if you were calling a method:, _(*5)

namespace FooModule\Factory\Controller;

use FooModule\Controller;
use RdnFactory\AbstractFactory;

class Bar extends AbstractFactory
{
    protected function create()
    {
        $config = $this->config('foo', 'bar');
        $modules = $this->service('ModuleManager');

        return new Controller\Bar($config, $modules);
    }
}

config(...$key)

Get configuration by key. You can pass multiple keys to traverse nested configuration items., _(*6)

// grab the 'display_exceptions' item inside the 'view_manager' array
$config = $this->config('view_manager', 'display_exceptions');

controller($name)

Get the controller with the given name., _(*7)

$controller = $this->controller('FooModule:BarController');

form($name)

Get a form/fieldset/element with the given name., _(*8)

$collection = $this->form('Collection');

$form = $this->form('FooModule:BarForm');

params($name)

Get a route parameter value., _(*9)

$id = $this->params('bar-id');

service($name)

Get a service from the top-level service locator (service manager)., _(*10)

$app = $this->service('Application');

$view = $this->service('ViewRenderer');

$uploads = $this->service('RdnUpload\Container');

url($route = null, $params = array(), $options = array(), $reuseMatchedParams = false)

This is just a proxy to the url()->fromRoute() controller plugin. Useful for generating URLs from within a factory., _(*11)

$apiUrl = $this->url('foo/api/search/user');