Yii2: Пример ActiveQuery и в чем причина генерации класса ActiveQuery отдельно в Gii?

Ответ 1

Активный запрос представляет собой запрос БД, связанный с классом Active Record. Он обычно используется для переопределения метода find() по умолчанию для конкретной модели, где он будет использоваться для генерации запроса перед отправкой в ​​БД:

class OrderQuery extends ActiveQuery
{
     public function payed()
     {
        return $this->andWhere(['status' => 1]);
     }

     public function big($threshold = 100)
     {
        return $this->andWhere(['>', 'subtotal', $threshold]);
     }

}

Если вы раньше работали с Yii 1, то это то, что заменяет Yii 1.x Named Scopes в Yii2. Все, что вам нужно сделать, это переопределить метод find() в классе модели, чтобы использовать класс ActiveQuery выше:

// This will be auto generated by gii if 'Generate ActiveQuery' is selected
public static function find()
{
    return new \app\models\OrderQuery(get_called_class());
}

Затем вы можете использовать его следующим образом:

$payed_orders      =   Order::find()->payed()->all();

$very_big_orders   =   Order::find()->big(999)->all();

$big_payed_orders  =   Order::find()->big()->payed()->all();

Другим вариантом использования того же класса ActiveQuery, который указан выше, является его использование при определении реляционных данных в соответствующем классе модели, например:

class Customer extends \yii\db\ActiveRecord
{
    ...

    public function getPayedOrders()
    {
        return $this->hasMany(Order::className(),['customer_id' => 'id'])->payed();
    }
}

Затем вы можете с нетерпением загружать клиентов своими соответствующими оплаченными заказами:

$customers = Customer::find()->with('payedOrders')->all();