thecodingmachine/common-factories

This project provides utility factories that can be used directly in service providers complying with the container-interop/service-provider standard.

, _(*1)

Utility factories for container-interop/service-provider

Work in progress., _(*2)

This project is part of the container-interop group. It tries to find a solution for cross-framework modules (aka bundles) by the means of container-agnostic configuration., _(*3)

Goal of this project

This project provides utility factories that can be used directly in service providers complying with the container-interop/service-provider standard., _(*4)

Those common factories can be detected by compiled/cached containers. The aim of this package is to offer a common set of useful classes that can also be preprocessed by optimized containers for best performance., _(*5)

Usage

Simply require this package in your package declaring your service-provider:, _(*6)

So far, the package has the thecodingmachine vendor name. It will hopefully be migrated to container-interop/common-factories, _(*7)

composer require thecodingmachine/common-factories

Then, you can use one of the 3 available classes:, _(*8)

Creating an alias

Use the Alias class to easily create an alias., _(*9)

public function getFactories() {
    return [
        'myAlias' => new Alias('myService')
    ]
}

can easily replace:, _(*10)

public function getFactories() {
    return [
        'myAlias' => function(ContainerInterface $container) {
            return $container->get('myService');
        }
    ]
}

Creating a parameter

Use the Parameter class to put in the container a scalar (or array of scalar) entry:, _(*11)

public function getFactories() {
    return [
        'DB_HOST' => new Parameter('localhost')
    ]
}

can easily replace:, _(*12)

public function getFactories() {
    return [
        'DB_HOST' => function() {
            return 'localhost';
        }
    ]
}

Appending a service to an array of services

Use the AddToArray class to push a new service to an existing array:, _(*13)

public function getExtensions() {
    return [
        MyTwigExtension::class => function() {
            return new MyTwigExtension();
        },
        'twig.extensions' => new AddToArray(MyTwigExtension::class)
    ]
}

can easily replace:, _(*14)

public function getExtensions() {
    return [
        MyTwigExtension::class => function() {
            return new MyTwigExtension();
        },
        'twig.extensions' => function(ContainerInterface $container, array $extensions = []) {
            $extensions[] = $container->get(MyTwigExtension::class);
            return $extensions;
        }
    ]
}