DEV Community

Cover image for 🚀 Contract Resolver: Auto-Bind Repositories & Services in Laravel
Taki Elias
Taki Elias

Posted on

🚀 Contract Resolver: Auto-Bind Repositories & Services in Laravel

#laravel #php #dependencyinversion #development

Are you tired of manually binding interfaces to implementations in Laravel? Or creating the same service and repository boilerplate over and over?

Meet Contract Resolver, a Laravel package that handles this for you — cleanly and automatically.

🎯 What Is It?

Contract Resolver helps you follow Laravel's Repository + Service pattern by:

  • Auto-binding interfaces to implementations
  • Generating services/repositories/interfaces using artisan commands
  • Supporting nested namespaces
  • Requiring zero dependencies

🔧 Installation 

composer require takielias/contract-resolver
Enter fullscreen mode Exit fullscreen mode

Optionally publish the config file:

php artisan vendor:publish --provider="TakiElias\ContractResolver\ContractResolverServiceProvider" --tag="contract-resolver.config"
Enter fullscreen mode Exit fullscreen mode

✨ Artisan Commands

You can generate everything interactively:

php artisan cr:make
Enter fullscreen mode Exit fullscreen mode

Or individually:

php artisan cr:make-repo Product
php artisan cr:make-service Product
Enter fullscreen mode Exit fullscreen mode

It also supports nested paths:

php artisan cr:make-repo Admin\\User
Enter fullscreen mode Exit fullscreen mode

📁 Convention-Based Binding

Just follow this structure:

app/
├── Contracts/
│   └── Repositories/
│       └── UserRepositoryInterface.php
├── Repositories/
│   └── UserRepository.php
Enter fullscreen mode Exit fullscreen mode

And the binding happens automatically! You can inject interfaces like:

public function __construct(UserRepositoryInterface $userRepo) {
    $this->userRepo = $userRepo;
}
Enter fullscreen mode Exit fullscreen mode

🧪 Testing

Run tests:

composer test
Enter fullscreen mode Exit fullscreen mode

With coverage:

composer test-coverage
Enter fullscreen mode Exit fullscreen mode

🛠 Why Use It?

✅ Clean, testable Laravel apps
✅ Focus more on business logic
✅ No need to manually bind contracts
✅ Fully customizable

🔗 Links

If you find this useful, give it a ⭐ on GitHub. I'd love your feedback or contributions!

Top comments (0)