Тригерится ли метод insert() в Yii2?

Краткий ответ

Да, метод insert() в Yii2 ActiveRecord триггерится, но с важными оговорками. Он вызывает события жизненного цикла модели, но не все события, характерные для процесса сохранения.

Подробное объяснение и контекст

В Yii2 ActiveRecord предоставляет несколько методов для работы с данными, включая save(), insert(), update(), delete(). Их поведение в отношении событий (events) различается.

События ActiveRecord в Yii2

Yii2 ActiveRecord имеет развитую систему событий жизненного цикла модели. Ключевые события:

• beforeValidate() / afterValidate()
• beforeSave() / afterSave()
• beforeInsert() / afterInsert()
• beforeUpdate() / afterUpdate()
• beforeDelete() / afterDelete()
• afterFind()

Какие события вызывает метод insert()?

Метод insert() НЕ вызывает событие beforeSave() / afterSave(). Это основное отличие от метода save().

Однако метод insert() явно вызывает следующие события:

1. beforeInsert() – непосредственно перед выполнением INSERT-запроса к БД.
2. afterInsert() – сразу после успешного выполнения INSERT-запроса.

Если перед вызовом insert() был выполнен validate() (или insert() вызывает его сам, в зависимости от параметров), то также могут сработать: 3. beforeValidate() / afterValidate().

Практический пример

Рассмотрим модель Article:

<?php
namespace app\models;

use yii\db\ActiveRecord;

class Article extends ActiveRecord
{
    public function beforeValidate()
    {
        if (!parent::beforeValidate()) {
            return false;
        }
        echo "Сработало beforeValidate\n";
        return true;
    }

    public function afterValidate()
    {
        parent::afterValidate();
        echo "Сработало afterValidate\n";
    }

    public function beforeInsert()
    {
        if (!parent::beforeInsert()) {
            return false;
        }
        echo "Сработало beforeInsert\n";
        // Можно установить атрибуты, например, дату создания
        if ($this->isNewRecord) {
            $this->created_at = time();
        }
        return true;
    }

    public function afterInsert()
    {
        parent::afterInsert();
        echo "Сработало afterInsert\n";
        // Можно выполнить действия, зависящие от нового ID
        \Yii::info("Создана статья с ID: {$this->id}", 'app');
    }

    public function beforeSave($insert)
    {
        if (!parent::beforeSave($insert)) {
            return false;
        }
        echo "Сработало beforeSave\n";
        return true;
    }

    public function afterSave($insert, $changedAttributes)
    {
        parent::afterSave($insert, $changedAttributes);
        echo "Сработало afterSave\n";
    }
}

Теперь протестируем:

$article = new Article();
$article->title = 'Новая статья';

// Этот вызов НЕ запустит события beforeSave/afterSave!
$success = $article->insert(); // В выводе будет: beforeValidate, afterValidate, beforeInsert, afterInsert

Сравнение insert() и save()

Рекомендации по использованию

• Для единичного сохранения новой модели практически всегда используйте $model->save(). Это обеспечивает согласованность, валидацию и срабатывание всех ожидаемых событий.
• Метод insert() полезен в узких сценариях:

    *   Когда нужна **массовая вставка** многих записей без накладных расходов на события `beforeSave/afterSave`. Для этого часто используют `batchInsert()` напрямую через `\Yii::$app->db`.
    *   При **наполнении базы** в миграциях или seed-данных.
    *   Когда необходимо **обойти бизнес-логику**, завязанную на обработчиках `beforeSave/afterSave` (хотя это часто указывает на архитектурный запах).

Вывод

Метод insert() в Yii2 действительно триггерит события жизненного цикла, но только специфичные для вставки (beforeInsert/afterInsert), пропуская общие события сохранения (beforeSave/afterSave). Это важное отличие, которое необходимо учитывать при проектировании логики приложения, особенно если в нем есть обработчики событий beforeSave/afterSave, выполняющие критическую бизнес-логику (аудитинг, инвалидацию кеша и т.д.). В 95% случаев использование save() является более правильным и безопасным выбором.