Qu'est-ce que le conteneur de services Laravel

Dans Laravel, le conteneur de services est un outil puissant pour gérer les dépendances de classe et implémenter l'injection de dépendances. Lorsqu'une application doit utiliser un certain service, le conteneur de services résoudra le service et résoudra automatiquement les dépendances entre les services, puis le remettra à l'application pour utilisation.

L'environnement d'exploitation de ce tutoriel : système Windows 7, version Laravel 6, ordinateur Dell G3.

Qu'est-ce qu'un conteneur de services

Le conteneur de services Laravel est un outil puissant pour gérer les dépendances de classe et implémenter l'injection de dépendances. Le terme injection de dépendances peut paraître sophistiqué à première vue, mais il signifie en réalité « injecter » des dépendances de classe dans une classe via le constructeur, ou dans certains cas via la méthode « setter ».

Les modules fonctionnels de Laravel tels que Route, Eloquent ORM, Request, Response, etc. sont en fait fournis par des modules de classe qui n'ont rien à voir avec le noyau. Ces classes sont en fait utilisées par nous depuis l'enregistrement jusqu'à l'instanciation. conteneur de laravel qui est responsable.

Il y a deux concepts dans le conteneur de service控制反转(IOC)和依赖注入(DI) :

L'injection de dépendances et l'inversion de contrôle sont des descriptions différentes de la même chose, et elles la décrivent sous des perspectives différentes. L'injection de dépendances est décrite du point de vue de l'application. L'application s'appuie sur le conteneur pour créer et injecter les ressources externes dont elle a besoin. L'inversion de contrôle est décrite du point de vue du conteneur. Le conteneur contrôle l'application et le conteneur injecte à l'envers les ressources externes requises par l'application dans l'application.

Dans Laravel, le framework lie ses différents services au conteneur de services. Nous pouvons également lier des services personnalisés au conteneur. Lorsqu'une application doit utiliser un certain service, le conteneur de services résoudra le service, résoudra automatiquement les dépendances entre les services, puis le remettra à l'application pour utilisation.

Discutons de la manière dont la liaison et l'analyse des services sont implémentées dans Laravel.

Liaison de service

Les méthodes couramment utilisées pour lier des services à des conteneurs incluent l'instance, la liaison, le singleton et l'alias. Examinons-les séparément.

instance

Liez un objet existant au conteneur de service Lorsque le service est ensuite résolu par son nom, le conteneur renverra toujours l'instance liée.

$api = new HelpSpot\API(new HttpClient);
$this->app->instance('HelpSpot\Api', $api);

enregistrera l'objet dans l'attribut $instnces du conteneur de service

［
     'HelpSpot\Api' => $api//$api是API类的对象，这里简写了
 ］

bind

Lier le service au conteneur de service

Il existe trois méthodes de liaison :

1. Se lier

$this->app->bind('HelpSpot\API', null);

2. . Fermeture de liaison

$this->app->bind('HelpSpot\API', function () {
    return new HelpSpot\API();
});//闭包直接提供类实现方式
$this->app->bind('HelpSpot\API', function ($app) {
    return new HelpSpot\API($app->make('HttpClient'));
});//闭包返回需要依赖注入的类

3. Interface de liaison et implémentation

$this->app->bind('Illuminate\Tests\Container\IContainerContractStub', 'Illuminate\Tests\Container\ContainerImplementationStub');

Dans le premier cas, en fait, à l'intérieur de la méthode bind, une fermeture est générée pour le service via getClosure() avant de lier le service. méthode de liaison. Code source.

public function bind($abstract, $concrete = null, $shared = false)
{
    $abstract = $this->normalize($abstract);
    
    $concrete = $this->normalize($concrete);
    //如果$abstract为数组类似['Illuminate/ServiceName' => 'service_alias']
    //抽取别名"service_alias"并且注册到$aliases[]中
    //注意：数组绑定别名的方式在5.4中被移除，别名绑定请使用下面的alias方法
    if (is_array($abstract)) {
        list($abstract, $alias) = $this->extractAlias($abstract);

        $this->alias($abstract, $alias);
    }

    $this->dropStaleInstances($abstract);

    if (is_null($concrete)) {
        $concrete = $abstract;
    }
    //如果只提供$abstract，则在这里为其生成concrete闭包
    if (! $concrete instanceof Closure) {
        $concrete = $this->getClosure($abstract, $concrete);
    }

    $this->bindings[$abstract] = compact('concrete', 'shared');

    if ($this->resolved($abstract)) {
        $this->rebound($abstract);
    }
}


protected function getClosure($abstract, $concrete)
{
    // $c 就是$container，即服务容器，会在回调时传递给这个变量
    return function ($c, $parameters = []) use ($abstract, $concrete) {
        $method = ($abstract == $concrete) ? 'build' : 'make';

        return $c->$method($concrete, $parameters);
    };
}

bind enregistre le service dans l'attribut $bindings du conteneur de service comme ceci :

$bindings = [
    'HelpSpot\API' =>  [//闭包绑定
        'concrete' => function ($app, $paramters = []) {
            return $app->build('HelpSpot\API');
        },
        'shared' => false//如果是singleton绑定，这个值为true
    ]        
    'Illuminate\Tests\Container\IContainerContractStub' => [//接口实现绑定
        'concrete' => 'Illuminate\Tests\Container\ContainerImplementationStub',
        'shared' => false
    ]
]

singleton

public function singleton($abstract, $concrete = null)
{
    $this->bind($abstract, $concrete, true);
}

singleton La méthode est une variante de la méthode bind Elle lie une classe ou une interface qui n'a besoin que d'être. analysé une fois dans le conteneur, puis ensuite, lorsque le conteneur appelle le service, il renverra la même instance

alias

Enregistrez le service et l'alias de service dans le conteneur :

public function alias($abstract, $alias)
{
    $this->aliases[$alias] = $this->normalize($abstract);
}

la méthode alias est utilisée dans la liaison méthode mentionnée ci-dessus, elle enregistrera le service. La relation correspondante entre les alias et les classes de service est enregistrée dans l'attribut $aliases du conteneur de service.

Par exemple :

$this->app->alias('\Illuminate\ServiceName', 'service_alias');

Après avoir lié le service, vous pouvez analyser l'objet de service via

$this->app->make('service_alias');

lorsque vous l'utilisez. De cette façon, vous n'avez pas besoin d'écrire ces noms de classe plus longs lors de la création de l'expérience d'utilisation. La méthode make est meilleure.

Analyse du service

make : analysez l'objet de service à partir du conteneur de service. Cette méthode reçoit le nom de la classe ou le nom de l'interface que vous souhaitez analyser en tant que paramètre

/**
 * Resolve the given type from the container.
 *
 * @param  string  $abstract
 * @param  array   $parameters
 * @return mixed
 */
public function make($abstract, array $parameters = [])
{
    //getAlias方法会假定$abstract是绑定的别名，从$aliases找到映射的真实类型名
    //如果没有映射则$abstract即为真实类型名，将$abstract原样返回
    $abstract = $this->getAlias($this->normalize($abstract));
    // 如果服务是通过instance()方式绑定的，就直接解析返回绑定的service
    if (isset($this->instances[$abstract])) {
        return $this->instances[$abstract];
    }
    // 获取$abstract接口对应的$concrete(接口的实现)
    $concrete = $this->getConcrete($abstract);
    if ($this->isBuildable($concrete, $abstract)) {
        $object = $this->build($concrete, $parameters);
    } else {
        //如果时接口实现这种绑定方式，通过接口拿到实现后需要再make一次才能
        //满足isBuildable的条件 ($abstract === $concrete)
        $object = $this->make($concrete, $parameters);
    }
    foreach ($this->getExtenders($abstract) as $extender) {
        $object = $extender($object, $this);
    }
    //如果服务是以singleton方式注册进来的则，把构建好的服务对象放到$instances里，
    //避免下次使用时重新构建
    if ($this->isShared($abstract)) {
        $this->instances[$abstract] = $object;
    }
    $this->fireResolvingCallbacks($abstract, $object);
    $this->resolved[$abstract] = true;
    return $object;
}
protected function getConcrete($abstract)
{
    if (! is_null($concrete = $this->getContextualConcrete($abstract))) {
        return $concrete;
    }
    // 如果是$abstract之前没有注册类实现到服务容器里，则服务容器会认为$abstract本身就是接口的类实现
    if (! isset($this->bindings[$abstract])) {
        return $abstract;
    }
    return $this->bindings[$abstract]['concrete'];
}
protected function isBuildable($concrete, $abstract)
{        
    return $concrete === $abstract || $concrete instanceof Closure;
}

En triant la méthode make, nous avons constaté que la méthode build La fonction est de construire l'objet de service analysé. Jetons un coup d'œil au processus spécifique de construction de l'objet. (La réflexion des classes PHP est utilisée pendant le processus de construction pour implémenter l'injection de dépendances des services)

public function build($concrete, array $parameters = [])
{
    // 如果是闭包直接执行闭包并返回（对应闭包绑定）
    if ($concrete instanceof Closure) {
        return $concrete($this, $parameters);
    }
    
    // 使用反射ReflectionClass来对实现类进行反向工程
    $reflector = new ReflectionClass($concrete);
    // 如果不能实例化，这应该是接口或抽象类，再或者就是构造函数是private的
    if (! $reflector->isInstantiable()) {
        if (! empty($this->buildStack)) {
            $previous = implode(', ', $this->buildStack);
            $message = "Target [$concrete] is not instantiable while building [$previous].";
        } else {
            $message = "Target [$concrete] is not instantiable.";
        }
        throw new BindingResolutionException($message);
    }
    $this->buildStack[] = $concrete;
    // 获取构造函数
    $constructor = $reflector->getConstructor();
    // 如果构造函数是空，说明没有任何依赖，直接new返回
    if (is_null($constructor)) {
        array_pop($this->buildStack);
        return new $concrete;
    }
    
    // 获取构造函数的依赖（形参），返回一组ReflectionParameter对象组成的数组表示每一个参数
    $dependencies = $constructor->getParameters();
    $parameters = $this->keyParametersByArgument(
        $dependencies, $parameters
    );
    // 构建构造函数需要的依赖
    $instances = $this->getDependencies(
        $dependencies, $parameters
    );
    array_pop($this->buildStack);
    return $reflector->newInstanceArgs($instances);
}
//获取依赖
protected function getDependencies(array $parameters, array $primitives = [])
{
    $dependencies = [];
    foreach ($parameters as $parameter) {
        $dependency = $parameter->getClass();
        // 某一依赖值在$primitives中(即build方法的$parameters参数)已提供
        // $parameter->name返回参数名
        if (array_key_exists($parameter->name, $primitives)) {
            $dependencies[] = $primitives[$parameter->name];
        } 
        elseif (is_null($dependency)) {
             // 参数的ReflectionClass为null，说明是基本类型，如'int','string'
            $dependencies[] = $this->resolveNonClass($parameter);
        } else {
             // 参数是一个类的对象， 则用resolveClass去把对象解析出来
            $dependencies[] = $this->resolveClass($parameter);
        }
    }
    return $dependencies;
}
//解析出依赖类的对象
protected function resolveClass(ReflectionParameter $parameter)
{
    try {
        // $parameter->getClass()->name返回的是类名（参数在typehint里声明的类型）
        // 然后递归继续make（在make时发现依赖类还有其他依赖，那么会继续make依赖的依赖
        // 直到所有依赖都被解决了build才结束)
        return $this->make($parameter->getClass()->name);
    } catch (BindingResolutionException $e) {
        if ($parameter->isOptional()) {
            return $parameter->getDefaultValue();
        }
        throw $e;
    }
}

Le conteneur de services est le cœur de Laravel. Il résout pour nous les interdépendances entre les objets grâce à l'injection de dépendances et contrôle également le transfert de la réflexion externe. pour définir des comportements spécifiques (Route, Eloquent, ce sont des modules externes, ils définissent leurs propres spécifications de comportement, le conteneur de services est responsable de ces classes depuis l'enregistrement jusqu'à l'instanciation pour votre usage).

Pour qu'une classe soit extraite par un conteneur, elle doit d'abord être enregistrée auprès du conteneur. Puisque Laravel appelle ce conteneur un conteneur de services, si nous avons besoin d'un service, nous devons d'abord enregistrer et lier le service au conteneur. Ensuite, la chose qui fournit le service et lie le service au conteneur est le fournisseur de services (ServiceProvider). Le fournisseur de services est principalement divisé en deux parties, register (enregistrement) et boot (démarrage, initialisation)

[Recommandations associées : tutoriel vidéo laravel]

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!