(Laravel) Dynamic dependency injection for interface, based on user input

Question

I am currently facing a very interesting dilemma with my architecture and implementation.

I have an interface called ServiceInterface which have a method called execute()

Then I have two different implementations for this interface: Service1 and Service2, which implements the execute method properly.

I have a controller called MainController and this controller has a "type-hint" for the ServiceInterface (dependency injection), it means that both, Service1 and Service2, can be called as resolution for that dependency injection.

Now the fun part:

I do not know which of those implementations to use (Service1 or Service2) because I just know if I can use one or other based on a user input from a previous step.

It means the user choose a service and based on that value I know if a can use Service1 or Service2.

I am currently solving the dependency injection using a session value, so depending of the value I return an instance or other, BUT I really think that it is not a good way to do it.

Please, let me know if you faced something similar and, how do you solve it, or what can I do to achieve this in the right way.

Thanks in advance. Please let me know if further information is required.

Answer 1

Finally, after some days of researching and thinking a lot about the best approach for this, using Laravel, I finally solved it.

I have to say that this was especially difficult in Laravel 5.2 because, in this version, the Session middleware only is executed in the controllers used in a route, it means that if for some reason I used a controller (not linked for a rote) and try to get access to the session it is not going to be possible.

So, because I cannot use the session, I decided to use URL parameters. Here you have the solution approach; I hope some of you found it useful.

so, you have an interface:

interface Service
{
    public function execute();
}

Then a couple of implementations for the interface:

Service one:

class ServiceOne implements Service
{
    public function execute()
    {
        .......
    }
}

Service two.

class ServiceTwo implements Service
{
    public function execute()
    {
        .......
    }
}

The interesting part is that I have a controller with a function with a dependency with the Service interface. Still, I need to resolve it dynamically to ServiceOne or ServiceTwo based on user input. So:

The controller

class MyController extends Controller
{
    public function index(Service $service, ServiceRequest $request)
    {
        $service->execute();
        .......
    }
}

Please note that ServiceRequest, validated that the request already have the parameter that we need to resolve the dependency (call it 'service_name')

Now, in the AppServiceProvider we can resolve the dependency in this way:

class AppServiceProvider extends ServiceProvider
{
    public function boot()
    {
        
    }

    public function register()
    {
        //This specific dependency is going to be resolved only if
        //the request has the service_name field stablished
        if(Request::has('service_name'))
        {
            //Obtaining the name of the service to be used (class name)
            $className = $this->resolveClassName(Request::get('service_name')));
            
            $this->app->bind('Including\The\Namespace\For\Service', $className);
        }
    }

    protected function resolveClassName($className)
    {
        $resolver = new Resolver($className);
        $className = $resolver->resolveDependencyName();
        return $className;
    }
}

So now all the responsibility is for the Resolver class. This class basically use the parameter passed to the constructor to return the full name (with namespace) of the class that is going to be used as an implementation of the Service interface:

class Resolver
{
    protected $name;
    public function __construct($className)
    {
        $this->name = $className;
    }

    public function resolveDependencyName()
    {
        //This is just an example, you can use whatever as 'service_one'
        if($this->name === 'service_one')
        {
            return Full\Namespace\For\Class\Implementation\ServiceOne::class;
        }
        
        if($this->name === 'service_two')
        {
            return Full\Namespace\For\Class\Implementation\ServiceTwo::class;
        }
        //If none, so throw an exception because the dependency can not be resolved 
        throw new ResolverException;
    }
}

Well, I really hope it helps some of you.

Best wishes!

---------- EDIT -----------

I just realize that it is not a good idea to use the request data directly inside the container of Laravel. It really is going to cause some trouble in the long term.

The best way is to directly register all the possible instances supported (serviceone and servicetwo) and then resolve one of them directly from a controller or a middleware, so then is the controller "who decides" what service to use (from all the available) based on the input from the request.

In the end, it works at the same, but it is going to allow you to work more naturally.

I have to say thanks to rizqi, a user from the questions channel of the slack chat of Laravel.

He personally created a golden article about this. Please read it because it solves this issue completely and in a very right way.

laravel registry pattern