php - Yii2：ActiveQuery 示例以及在 Gii 中单独生成 ActiveQuery 类的原因是什么？

Question

您能否提供一个示例用法。描述将不胜感激。我找不到一个很好的例子。

Answer 1

Active Query表示与Active Record类关联的 DB 查询。它通常用于覆盖find()特定模型的默认方法，用于在发送到 DB 之前生成查询：

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

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

}

如果你之前使用过 Yii 1，那么这就是Yii2 中Yii 1.x 命名范围的替换。您所要做的就是覆盖模型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();