Injection de Dépendance¶

Ajouter des Services Partagés¶

Par défaut, les services ne sont pas partagés. Chaque objet (et dépendance) est recréé à chaque récupération auprès du conteneur. Si vous voulez réutiliser une instance, souvent référencée comme un singleton, vous pouvez marquer un service comme “partagé”:

// dans votre méthode Application::services()

$container->share(BillingService::class);

Étendre des Définitions¶

Après avoir défini un service, vous pouvez modifier ou mettre à jour sa définition en l’étendant. Cela vous permet d’ajouter des arguments supplémentaires définis ailleurs:

// Ajouter un argument à un service partiellement défini ailleurs.
$container->extend(BillingService::class)
    ->addArgument('logLevel');

Étiqueter des Services¶

En ajoutant une étiquette (<em>tag</em>) à des services, vous pouvez les résoudre tous en même temps. Cela peut servir à construire des services qui combinent des collections d’autres services, comme dans un système de reporting:

$container->add(BillingReport::class)->addTag('reports');
$container->add(UsageReport::class)->addTag('reports');

$container->add(ReportAggregate::class, function () use ($container) {
    return new ReportAggregate($container->get('reports'));
});

Utiliser les Données de Configuration¶

Souvent, vous aurez besoin des données de configuration dans vos services. Bien que vous puissiez ajouter dans le conteneur toutes les clés de configuration dont votre service a besoin, cela risque d’être fastidieux. Pour faciliter le travail de configuration, CakePHP inclut un lecteur de configuration injectable:

use Cake\Core\ServiceConfig;

// Utilisez une instance partagée
$container->share(ServiceConfig::class);

La classe ServiceConfig fournit une vue en lecture seule de toutes les données disponibles dans Configure, ainsi vous n’avez pas à vous soucier d’une modification accidentelle de la configuration.

Créer des Service Providers¶

Un exemple de <em>Service Provider</em> pourrait être:

namespace App\ServiceProvider;

use Cake\Core\ContainerInterface;
use Cake\Core\ServiceProvider;
// Autres imports ici.

class BillingServiceProvider extends ServiceProvider
{
    protected $provides = [
        StripeService::class,
        'configKey',
    ];

    public function services(ContainerInterface $container): void
    {
        $container->add(StripService::class);
        $container->add('configKey', 'some value');
    }
}

Les fournisseurs de services utilisent leur méthode services() pour définir tous les services qu’ils proposent. De plus, ces services doivent être définis dans la propriété $provides. Ne pas inclure un service dans la propriété $provides empêchera son chargement par le conteneur.

Utiliser des Service Providers¶

Pour charger un <em>service provider</em>, ajoutez-le au conteneur en utilisant la méthode addServiceProvider():

// dans votre méthode Application::services()
$container->addServiceProvider(new BillingServiceProvider());

ServiceProviders Bootables¶

Si votre <em>service provider</em> a besoin d’exécuter un traitement au moment où il est ajouté au conteneur, vous pouvez implémenter la méthode bootstrap(). Cette situation peut se produire si votre <em>service provider</em> a besoin de charger des fichiers de configuration supplémentaires, de charger des <em>service providers</em> supplémentaires, ou de modifier un service défini ailleurs dans votre application. Un exemple de service bootable serait:

namespace App\ServiceProvider;

use Cake\Core\ServiceProvider;
// Autres imports ici.

class BillingServiceProvider extends ServiceProvider
{
    protected $provides = [
        StripeService::class,
        'configKey',
    ];

    public function bootstrap($container)
    {
        $container->addServiceProvider(new InvoicingServiceProvider());
    }
}