Yii2. Контейнер внедрения зависимостей (dependency injection container)

<?php
 
namespace app\services;
 
use yii\mail\MailerInterface;
use app\forms\SupportRequestCreateForm;
 
class SupportManager
{
    private $mailer;
    private $adminEmail;
 
    public function __construct(MailerInterface $mailer, string $adminEmail)
    {
        $this->mailer = $mailer;
        $this->adminEmail = $adminEmail;
    }
 
    public function createRequest(SupportRequestCreateForm $form)
    {
        // ...
        $this->mailer->compose()
            ->setTo($this->adminEmail)
            ->setFrom($form->email)
            ->setSubject($form->subject)
            ->setTextBody($form->body)
            ->send();
        // ...
    }
}

<?php
 
namespace app\controllers;
 
use Yii;
use yii\web\Controller;
use app\forms\SupportRequestCreateForm;
use app\services\SupportManager;
 
class SiteController extends Controller
{
    // ...
 
    public function actionSupport()
    {
        $form = new SupportRequestCreateForm();
 
        if ($form->load(Yii::$app->request->post()) && $form->validate()) {
            Yii::$container->get(SupportManager::class)->createRequest($form);
            Yii::$app->session->setFlash('SupportRequestCreated');
 
            return $this->refresh();
        }
        return $this->render('contact', ['form' => $form]);
    }
 
    // ...
}

<?php
 
namespace app\bootstrap;
 
use Yii;
use yii\di\Instance;
use yii\mail\MailerInterface;
use yii\base\BootstrapInterface;
use app\services\SupportManager;
 
class ServicesDefinitions implements BootstrapInterface
{
    public function bootstrap($app)
    {
        // Способ 1.
        // Обычно применяется когда классы-зависимости используются только один раз.
        // $app->container->setSingleton(SupportManager::class, function() use ($app) {
        //     return new SupportManager($app->mailer, $app->params['adminEmail']);
        // });
 
        // Способ 2.
        // Обычно применяется когда классы-зависимости используются неоднократно и в разных местах.
        // В данном случае Instance::of(MailerInterface::class) дает возможность не плодить экземпляры
        // Mailer'a, а использовать один и тот же объект.
        $app->container->setSingleton(MailerInterface::class, function() use($app) {
            return $app->mailer;
        });
        $app->container->setSingleton(SupportManager::class, [], [
            Instance::of(MailerInterface::class),
            $app->params['adminEmail']
        ]);
        // $app->container->setSingleton(ExampleOtherClass::class, [], [
        //     Instance::of(MailerInterface::class),
        //     $app->params['adminEmail']
        // ]);
    }
}

<?php
 
$config = [
    // ...
    'bootstrap' => ['log', 'app\bootstrap\ServicesDefinitions'],
    // ...
];

$container = new \yii\di\Container;
 
// Регистрация имени класса, как есть. Это может быть пропущено.
$container->set('yii\db\Connection');
 
// Регистрация интерфейса.
// Когда класс зависит от интерфейса, соответствующий класс
// будет использован в качестве зависимости объекта.
$container->set('yii\mail\MailInterface', 'yii\swiftmailer\Mailer');
 
// Регистрация псевдонима(алиаса). Вы можете использовать $container->get('foo')
// для создания экземпляра Connection.
$container->set('foo', 'yii\db\Connection');
 
// Регистрация класса с конфигурацией. Конфигурация
// будет применена при создании экземпляра класса через get().
$container->set('yii\db\Connection', [
    'dsn' => 'mysql:host=127.0.0.1;dbname=demo',
    'username' => 'root',
    'password' => '',
    'charset' => 'utf8',
]);
 
// Регистрация псевдонима(алиаса) с конфигурацией класса.
// В данном случае, параметр "class" требуется для указания класса.
$container->set('db', [
    'class' => 'yii\db\Connection',
    'dsn' => 'mysql:host=127.0.0.1;dbname=demo',
    'username' => 'root',
    'password' => '',
    'charset' => 'utf8',
]);
 
// Регистрация PHP callback'a.
// Callback будет выполняться каждый раз при вызове $container->get('db').
$container->set('db', function ($container, $params, $config) {
    return new \yii\db\Connection($config);
});
 
// Регистрация экземпляра компонента.
// $container->get('pageCache') вернёт тот же экземпляр при каждом вызове.
$container->set('pageCache', new FileCache);

class FooBuilder
{
    public static function build($container, $params, $config)
    {
        $foo = new Foo(new Bar);
        // ... дополнительная инициализация ...
        return $foo;
    }
}
 
$container->set('Foo', ['app\helper\FooBuilder', 'build']);
 
$foo = $container->get('Foo');

\Yii::$container->set('yii\widgets\LinkPager', ['maxButtonCount' => 5]);