Yii2框架中如何覆盖ProjectQuery初始化时的默认查询条件？

嘿，你的这个需求其实很常见，完全不需要替换init()方法——默认全局加deleted=0的逻辑是合理的，我们只需要通过扩展查询类或者直接调整查询语句，就能在特殊场景下覆盖这个条件。下面给你两种实用的方案：

方案一：新增withDeleted()方法（推荐） #

给ProjectQuery加一个专门的方法，用来灵活切换是否包含已删除项目，这样代码可读性高，也符合Yii2的查询类设计风格：

class ProjectQuery extends \yii\db\ActiveQuery {
    public function init() {
        $this->andOnCondition(['deleted' => 0]);
        parent::init();
    }

    // 新增方法：支持查询已删除项目
    public function withDeleted($includeAll = false) {
        if ($includeAll) {
            // 清空默认的deleted条件，允许查询所有状态的项目
            $this->onCondition([]);
        } else {
            // 如果需要只查已删除的，可以单独用这个分支
            $this->andOnCondition(['deleted' => 1]);
        }
        return $this; // 保持链式调用的能力
    }
}

使用起来非常直观：

• 正常查询（默认只返回未删除项目）：Project::find()->all();
• 查询所有项目（包含已删除）：Project::find()->withDeleted(true)->all();
• 只查询当前用户的已删除项目：Project::find()->withDeleted()->andWhere(['user_id' => Yii::$app->user->id])->all();

方案二：直接在查询时覆盖条件 #

如果只是偶尔的特殊场景，也可以不用新增方法，直接在查询语句中修改条件：

// 示例：查询当前用户的已删除项目
Project::find()
    // 用onCondition替换默认的deleted=0条件
    ->onCondition(['deleted' => 1, 'user_id' => Yii::$app->user->id])
    ->all();

这里要注意：andOnCondition是叠加条件，而onCondition会替换已有的关联条件，所以如果需要完全覆盖默认的deleted=0，用onCondition更合适。

为什么不用替换init()？ #

init()是查询对象初始化时的钩子，在这里设置默认全局条件是标准做法。我们只需要在特殊查询时通过链式调用修改条件即可，这样既保留了默认的安全过滤（避免误查已删除数据），又能灵活应对特殊场景，不用破坏原有逻辑。

内容的提问来源于stack exchange，提问作者dgtal