An open API service indexing awesome lists of open source software.

https://github.com/enzyme/laravel-binder

A service container contextual binding helper for Laravel 5.
https://github.com/enzyme/laravel-binder

Last synced: 8 months ago
JSON representation

A service container contextual binding helper for Laravel 5.

Awesome Lists containing this project

README

          

# Binder

[![Build Status](https://travis-ci.org/enzyme/laravel-binder.svg?branch=master)](https://travis-ci.org/enzyme/laravel-binder)
[![Coverage Status](https://coveralls.io/repos/github/enzyme/laravel-binder/badge.svg?branch=master)](https://coveralls.io/github/enzyme/laravel-binder?branch=master)
[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/enzyme/laravel-binder/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/enzyme/laravel-binder/?branch=master)

A contextual binding helper for Laravel 5.

# Example

#### From the service provider.

```php
use Enzyme\LaravelBinder\Binder;

// Inside the app service provider...
public function register()
{
$binder = new Binder($this->app);

$binder->setAlias(
'controller.listing',
'App\Http\Controllers\ListingController'
);

$binder->setAlias(
'repos.interface',
'Acme\Repositories\RepositoryInterface'
);

// Option 1 for binding, using aliases.
$binder->setBinding(
'repos.listing',
'repos.interface',
'Acme\Repositories\ListingRepository'
);

// Option 2 for binding, using FQNs.
$binder->setBinding(
'factories.listing',
'Acme\Factories\FactoryInterface',
'Acme\Factories\ListingFactory'
);

// Tell the service container that the ListingController
// needs the ListingRepository & ListingFactory.
$binder->setNeeds(
'controller.listing',
['repos.listing', 'factories.listing']
);

$binder->register();
}
```

#### From the controller

```php
// You don't need to inject the specific concrete classes, just the
// interfaces. The Binder + Service Container has taken care of it for you.
public function __construct(RepositoryInterface $repo, FactoryInterface $factory)
{
$this->repo = $repo;
$this->factory = $factory;
}
```

# What's the purpose?

With your service provider(s) now being the sole authority for which classes get what implementations, if you ever need to switch those implementations, it's dead simple and in one spot!