madewithlove/definitions

A repository of universal service providers for service-providers compliant containers

Madewithlove Service Providers

![Latest Version on Packagist][ico-version] ![Coverage Status][ico-scrutinizer] ![Total Downloads][ico-downloads], _(*1)

A repository of universal service providers for [service-providers] compliant containers, _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require madewithlove/service-providers, <sub>(*4)</sub>

This repository **does not** ship with any third party package, you will need to install them yourself. If per example you need the `FlysystemServiceProvider` you would install Flysystem alongside this package.

## Usage

### Service providers

If the container you're using is already compatible with [service-provider] then register it like you simply would normally.

Otherwise you can use a decorator or bridge, you can find some on Packagist, and this package ships with some as well, per example for [league/container]:

```php
use League\Flysystem\FilesystemInterface;
use League\League\Container;
use Madewithlove\ServiceProviders\Bridges\LeagueContainerDecorator;
use Madewithlove\ServiceProviders\Filesystem\FlysystemServiceProvider;

$container = new LeagueContainerDecorator(new Container());
$container->addServiceProvider(new FlysystemServiceProvider(...)));

$filesystem = $container->get(FilesystemInterface::class);

For providers with configuration, you can pass it as constructor argument. See the provider's signature for what options they take:, <sub>(*5)</sub>

$provider = new EloquentServiceProvider([
    'local' => [
        'driver' => 'sqlite',
        'etc' => 'etc,
    ],
    'production' => [
        'driver' => 'mysql',
        'etc' => 'etc,
    ],
]);

Utilities

This package also ships with some utilities to write your own service providers:, <sub>(*6)</sub>

Alias: An alias to an existing value in the container:, <sub>(*7)</sub>

public function getServices()
{
    return ['my_alias' => new Alias('to_something_else')];
}

Parameter: A plain value to store in the container:, <sub>(*8)</sub>

public function getServices()
{
    return ['views_path' => new Parameter(__DIR__.'/views)];
}

ParametersServiceProvider: A blank service provider to quickly set multiple values in the container:, <sub>(*9)</sub>

new ParametersServiceProvider([
    'foo' => 'bar',
    'bar' => 'baz',
]);

$container->get('foo'); // (string) "bar"

PrefixedProvider: A decorator to prefix a provider's services with a given string:, <sub>(*10)</sub>

new PrefixedProvider('config', new ParametersServiceProvider([
    'foo' => 'bar',
]));

$container->get('config.foo'); // (string) "bar"

Available service providers

├── Bridges
│   └── LeagueContainerDecorator.php
├── CommandBus
│   └── TacticianServiceProvider.php
├── Console
│   └── SymfonyConsoleServiceProvider.php
├── Database
│   ├── EloquentServiceProvider.php
│   └── FactoryMuffinServiceProvider.php
├── Development
│   ├── DebugbarServiceProvider.php
│   └── MonologServiceProvider.php
├── Events
│   └── LeagueEventsServiceProvider.php
├── Filesystem
│   └── FlysystemServiceProvider.php
├── Http
│   ├── LeagueRouteServiceProvider.php
│   ├── RelayServiceProvider.php
│   └── ZendDiactorosServiceProvider.php
├── Templating
│   └── TwigServiceProvider.php
└── Utilities
    ├── Alias.php
    ├── Parameter.php
    ├── ParametersServiceProvider.php
    └── PrefixedProvider.php

See the constructor arguments of each for the options they take. Contributions welcome!, <sub>(*11)</sub>

Change log

Please see CHANGELOG for more information what has changed recently., <sub>(*12)</sub>

Testing

bash $ composer test, <sub>(*13)</sub>

Contributing

Please see CONTRIBUTING and CONDUCT for details., <sub>(*14)</sub>

Security

If you discover any security related issues, please email heroes@madewithlove.be instead of using the issue tracker., <sub>(*15)</sub>

Credits

• Anahkiasen
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*16)</sub>