thecodingmachine/container-discovery

Allowing discovery of container objects

Containers discovery for container-interop

This package contains an interface and Puli binding-types to automatically discover containers., _(*1)

Introduction

container-interop defines a common interface for Container objects (the ContainerInterface). This package proposes a default interface for factories that can generate container objects., _(*2)

This factory is static and can be automatically detected by Puli using class discovery., _(*3)

The goal is to allow a composite container to automatically detect and create container instances., _(*4)

Installation

composer require thecodingmachine/container-discovery@dev

This package adheres to the SemVer specification and will be fully backward compatible between minor versions., _(*5)

Containers discovery

The goal of this package is to enable a package to automatically publish or discover containers., _(*6)

To automatically provide a container to your application, we use Puli's discovery mechanism., _(*7)

This package contains a Puli binding-type named container-interop/ContainerFactories. This binding-type should contain fully qualified class names implementing the ContainerFactoryInterface interface., _(*8)

Providing containers

To provide a container, write a ContainerFactory that will return an instance of your container implementing ContainerInterface., _(*9)

For instance (using Picotainer):, _(*10)

namespace My\Package;

use Interop\Container\Factory\ContainerFactoryInterface;
use Assembly\ArrayDefinitionProvider;

class MyContainerFactory implements ContainerFactoryInterface {
    public static function buildContainer(ContainerInterface $rootContainer, Discovery $discovery) {
        return new Picotainer([
            'logger' => function() {
                new MyLogger();
            },
            $rootContainer
        ]);    
    }
}

Once your class is written, use Puli to bind it to the list of available containers:, _(*11)

$ puli bind "My\\Package\\MyContainerFactory" container-interop/ContainerFactories

Note: by convention, you can add a "priority" parameter to the binding. Default priority is 0. Lower priorities are processed first (and therefore, higher priorities are overloading lower priorities)., _(*12)

$ puli bind "My\\Package\\MyContainerFactory" container-interop/ContainerFactories --param priority=42

Consuming containers

In your code, you can find all classes of the container-interop/ContainerFactories binding-type using:, _(*13)

// $discovery is the Puli Discovery object.

$factories = $discovery->findByType('container-interop/ContainerFactories');

// TODO: sample code to sort by priority.