Класс yii\di\Instance

Instance представляет ссылку на именованный объект в контейнере инъекции зависимостей (DI) или локаторе сервисов.

Вы можете использовать get() для получения фактического объекта, на который ссылается $id.

Класс Instance используется в основном в двух случаях:

• При конфигурировании контейнера инъекции зависимостей, вы используете Instance для ссылки на имя класса, имя интерфейса или псевдоним. Ссылка может быть позже разрешена в фактический объект контейнером.
• В классах, которые используют локатор сервисов для получения зависимых объектов.

Следующий пример демонстрирует, как настроить контейнер DI с Instance:

$container = new \yii\di\Container;
$container->set('cache', [
    'class' => 'yii\caching\DbCache',
    'db' => Instance::of('db')
]);
$container->set('db', [
    'class' => 'yii\db\Connection',
    'dsn' => 'sqlite:path/to/file.db',
]);

И следующий пример показывает, как класс получает компонент из локатора сервисов:

class DbCache extends Cache
{
    public $db = 'db';

    public function init()
    {
        parent::init();
        $this->db = Instance::ensure($this->db, 'yii\db\Connection');
    }
}

Общедоступные свойства

Общедоступные методы

Защищенные методы

Подробности свойств

$id общедоступное свойство

Идентификатор компонента, имя класса, имя интерфейса или псевдоним

public string $id = null

Подробности методов

use yii\db\Connection;

// returns Yii::$app->db
$db = Instance::ensure('db', Connection::className());
// returns an instance of Connection using the given configuration
$db = Instance::ensure(['dsn' => 'sqlite:path/to/my.db'], Connection::className());