在 Yii 2.0 中，核心验证器：unique (唯一性) 支持多个模型与变量的实现

1、涉及至第 1 张表，企鹅号的文章：cpa_qq_article，需要验证其字段：title 的唯一性，表结构如图1

图1

2、涉及至第 2 张表，渠道的应用的任务：cpa_channel_app_task，字段：task_id 与 企鹅号的文章的字段：task_id 存在关联关系(多对一)，字段：channel_app_source_uuid 为条件(变量、请求参数)，字段：status 为条件(常量)，表结构如图2

图2

3、filter：用于检查输入值唯一性必然会进行数据库查询，而该属性为用于进一步筛选该查询的过滤条件。样式为 function ($query) 的匿名函数， $query 参数为你希望在该函数内进行修改的 Query 对象。模型中的验证规则声明如下：

    /**
     * {@inheritdoc}
     */
    public function scenarios()
    {
        $scenarios = parent::scenarios();
        $scenarios[self::SCENARIO_CREATE] = ['group_id', 'article_category_id', 'title', 'author', 'source_article_id'];

        return $scenarios;
    }

    /**
     * @inheritdoc
     */
    public function rules()
    {
        $rules = [
            ['title', 'unique', 'filter' => function ($query) {
                /* @var $query ChannelAppTaskQuery */
                $query->joinWith('channelAppTask', false)->andWhere([ChannelAppTask::tableName() . '.status' => ChannelAppTask::STATUS_PLATFORM_PUBLISHED]);
            }, 'on' => self::SCENARIO_CREATE],
        ];
        $parentRules = parent::rules();

        return ArrayHelper::merge($rules, $parentRules);
    }

    /*
     * 声明了一个渠道的应用的任务关联
     */
    public function getChannelAppTask()
    {
        return $this->hasOne(ChannelAppTask::className(), ['task_id' => 'task_id']);
    }

4、验证请求参数时，生成的 SQL 如下：

SELECT EXISTS(SELECT `cpa_qq_article`.* FROM `cpa_qq_article` LEFT JOIN `cpa_channel_app_task` ON `cpa_qq_article`.`task_id` = `cpa_channel_app_task`.`task_id` WHERE (`cpa_qq_article`.`title`='未来 10 年，“星光中国芯工程”计划投资 100 亿元用于芯片研发及大规模产业化。') AND (`cpa_channel_app_task`.`status`=6))

5、请求参数中，存在 channel_app_source_uuids 字段，其值为数组：[“8d72b7cc2ac911eab85a54ee75d2ebc1”, “18cf06d22ac911eaa31854ee75d2ebc1”]，需要将 channel_app_source_uuids 的值做为条件应用于唯一性验证的查询条件中。在执行模型的验证之前，赋值给应用的全局参数变量 Yii::$app->params。如图3

图3

$requestParams = Yii::$app->getRequest()->getBodyParams();
Yii::$app->params['channelAppSourceUuids'] = $requestParams['channel_app_source_uuids'];

6、现在可在验证规则中使用 Yii::$app->params，模型中的验证规则声明调整如下：

    /**
     * @inheritdoc
     */
    public function rules()
    {
        $rules = [
            ['title', 'unique', 'filter' => function ($query) {
                /* @var $query ChannelAppTaskQuery */
                $query->joinWith('channelAppTask', false)->andWhere(['and', ['in', ChannelAppTask::tableName() . '.channel_app_source_uuid', Yii::$app->params['channelAppSourceUuids']], [ChannelAppTask::tableName() . '.status' => ChannelAppTask::STATUS_PLATFORM_PUBLISHED]]);
            }, 'on' => self::SCENARIO_CREATE],
        ];
        $parentRules = parent::rules();

        return ArrayHelper::merge($rules, $parentRules);
    }

7、验证请求参数时，生成的 SQL 如下，请求参数已经应用于查询条件中，符合预期

SELECT EXISTS(SELECT `cpa_qq_article`.* FROM `cpa_qq_article` LEFT JOIN `cpa_channel_app_task` ON `cpa_qq_article`.`task_id` = `cpa_channel_app_task`.`task_id` WHERE (`cpa_qq_article`.`title`='未来 10 年，“星光中国芯工程”计划投资 100 亿元用于芯片研发及大规模产业化。') AND ((`cpa_channel_app_task`.`channel_app_source_uuid` IN ('8d72b7cc2ac911eab85a54ee75d2ebc1', '18cf06d22ac911eaa31854ee75d2ebc1')) AND (`cpa_channel_app_task`.`status`=6)))

8、核心验证器：unique (唯一性) 支持多个模型与变量的实现，验证失败时，响应如下，如图4

图4

{
    "code": 226004,
    "message": "数据验证失败：标题的值\"未来 10 年，“星光中国芯工程”计划投资 100 亿元用于芯片研发及大规模产业化。\"已经被占用了。"
}