README

Bindify

Bindify is a Laravel package that provides attributes to bind interfaces to their implementations lazily.

Note

This package requires PHP 8.2+

Features ✨

• Declarative bindings using #[BindWith] attributes
• Lazy registration (bindings are registered when first resolved)
• Seamless integration with Laravel's service container
• Multiple binding types (Singleton, Transient)
• Tagged bindings

Installation

You can install the package via composer:

composer require algoyounes/bindify

Usage

Basic Binding

Define your interface with the #[BindWith] attribute:

namespace App\Contracts;

use AlgoYounes\Bindify\Attributes\BindWith;
use AlgoYounes\Bindify\Attributes\BindType;
use App\Services\DefaultService;

#[BindWith(DefaultService::class, BindType::Singleton)]
interface ServiceContract
{
    public function execute();
}

Create your implementation:

namespace App\Services;

use App\Contracts\ServiceContract;

class DefaultService implements ServiceContract
{
    public function execute()
    {
        // Your implementation
    }
}

Binding Types

Advanced Binding

Multiple Implementations

Bind multiple implementations to an interface:

namespace App\Contracts;

use AlgoYounes\Bindify\Attributes\BindWith;
use AlgoYounes\Bindify\Attributes\BindType;

#[BindWith([DefaultService::class, AlternativeService::class], BindType::Singleton)]
interface ServiceContract
{
    // ...
}

Tagged Bindings

Explicitly tag your bindings:

#[BindWith([DefaultService::class], BindType::Singleton, tag: 'primary')]

Note

When no tag is provided and there are multiple services, will auto-generates a tag by appending <class_name>_tag

Retrieving Bindings

Resolve your bindings as usual through container:

$service = app(ServiceContract::class);

$services = app()->tagged('primary');

Contributing

Thank you for considering contributing to this package! Please check the CONTRIBUTING file for more details.

License

This package is open-sourced software licensed under the MIT license.