Ausführliche Erläuterung zur Verwendung der Yii2-Framework-Datenüberprüfung

Dieses Mal werde ich Ihnen die Verwendung der Yii2-Framework-Datenüberprüfung ausführlich erläutern. Was sind die Vorsichtsmaßnahmen für die Verwendung der Yii2-Framework-Datenüberprüfung? Das Folgende ist ein praktischer Fall.

1. Szenarien

Unter welchen Umständen müssen Sie Szenarien verwenden? Wenn ein Modell in verschiedenen Szenarien verwendet werden muss und die in verschiedenen Szenarien erforderlichen Datentabellenfelder und Datenvalidierungsregeln unterschiedlich sind, müssen mehrere Szenarien definiert werden, um verschiedene Verwendungsszenarien zu unterscheiden. Beispielsweise müssen -Benutzer bei der Registrierung ihre E-Mail-Adresse angeben, nicht jedoch beim Anmelden. In diesem Fall müssen zwei verschiedene Szenarien definiert werden, um sie zu unterscheiden.

Standardmäßig werden die Szenarios des Modells durch die Szenarios bestimmt, die in den von der Methode rules() deklarierten Validierungsregeln verwendet werden. Sie können auch alle Szenarios des Modells genauer definieren, indem Sie die Methode scenarios() überschreiben , zum Beispiel:

public function scenarios() {
    return [
      'signup' => ['username', 'email', 'password', 'conpassword', 'verifyCode', 'reg_time', 'log_time'],
      'login' => ['username', 'password', 'verifyCode', 'rememberMe', 'log_time']
    ];
}

Der Schlüssel ist der Szenenname und der Wert ist das in der Szene verwendete Modellattribut (das sogenannte Aktivitätsattribut).

Es gibt zwei Möglichkeiten, die Modellszene anzugeben:

Methode eins:

$model = new User();
$model->scenario = 'signup';

Methode zwei:

$model = new User(['scenario' => 'signup']);

Sie können das anwendbare Szenario einer Validierungsregel deklarieren, indem Sie das Attribut „on“ in der Validierungsregel angeben:

['email', 'required', 'on' => 'signup']

Das Szenario wird hauptsächlich für die Zuweisung von Modellattributblöcken und die Datenüberprüfung verwendet. Beim Aufruf der Methode load() der Modellklasse zur Blockzuweisung werden nur die Attribute zugewiesen, die der aktuellen Szene entsprechen. Beim Aufruf der Methode validate() der Modellklasse zur Datenüberprüfung werden nur die Attribute der aktuellen Szene zugewiesen relevant und anwendbar auf die aktuelle Szene. Die Validierungsregeln werden ausgeführt.

2. Validierungsregeln

Die Yii-Modellklasse deklariert alle Validierungsregeln, die durch die Implementierung der Rules()-Methode verwendet werden, Beispiel:

public function rules() {
    return [
      [['username', 'password'], 'required'],
      ['email', 'email', 'on' => 'signup']
    ];
}

Eine Regel kann auf ein oder mehrere Szenarios angewendet werden, eine Regel kann zur Überprüfung eines oder mehrerer Attribute verwendet werden und ein Attribut kann einer oder mehreren Überprüfungsregeln entsprechen. Wenn das Attribut „on“ nicht angegeben ist, wird die Validierungsregel in allen Szenarios verwendet.

Alle Validierungsregeln können die Fehlermeldung anpassen, indem sie das Attribut „Nachricht“ festlegen, und der aktuelle Attributbeschriftungsname kann über {attribute} im Inhalt der Fehlermeldung referenziert werden (der Attributbeschriftungsname muss im enthalten sein). Die Einstellung der attributeLabels( )-Methode des Modells) beziehen sich auf den Eingabewert des aktuellen Attributs über {value}, zum Beispiel:

['username', 'unique', 'on' => register', 'message' => '{attribute}"{value}" ist bereits belegt! ', 'on' => 'signup']//Der Benutzername ist bei der Registrierung eindeutig

Es gibt drei Möglichkeiten, die yii-Verifizierung zu verwenden:

1 Seitliche Überprüfung:

Yii aktiviert standardmäßig die clientseitige Überprüfung. Sie können sie aktivieren, indem Sie den Parameter „enableClientValidation“ auf „true“ setzen. Nach dem Einschalten liest ActiveForm die in definierten Überprüfungsregeln das Modell und generieren den entsprechenden Javascript-Verifizierungscode. Es gibt drei Möglichkeiten, den Parameter „enableClientValidation“ festzulegen:

(1) Legen Sie das gesamte Formular in der Ansichtsdatei ActiveForm fest:

<?php
$form = ActiveForm::begin([
  &#39;enableClientValidation&#39; =>true
]);
?>

(2) Legen Sie ein einzelnes Feld in der Ansichtsdatei ActiveField fest:

<?= $form->field($model, &#39;username&#39;, [&#39;enableClientValidation&#39;=>false])->label(&#39;用户名&#39;) ?>

(3) In der Rules()-Funktion der AR-Klasse festgelegt:

['username', 'yii\validators\StringValidator', 'min' => 3, 'max' => 30, 'enableClientValidation' => true, 'on' => 'register']

Priorität: (2)>(1)>( 3)

2. Serverseitige Überprüfung:

(1) validieren()

Die Methode validate() basiert auf Rules()-Methode Die definierten Validierungsregeln validieren alle Daten und geben true zurück, wenn die Validierung erfolgreich ist. Andernfalls werden die Fehler im Attribut yiibaseModel::errors gespeichert und false zurückgegeben.

(2) save()

Die Modell-save()-Methode ruft standardmäßig die validate()-Methode zur Datenüberprüfung auf. Wenn die Überprüfung erfolgreich ist, wird der Datenbankvorgang durchgeführt wird direkt ausgeführt und gibt true zurück, andernfalls wird keine Datenbankoperation ausgeführt, false wird zurückgegeben und die Fehlerinformationen werden im Attribut yiibaseModel::errors gespeichert. Wenn „validate()“ explizit aufgerufen wurde, können Sie die wiederholte Validierung der Daten in der Methode „save()“ vermeiden, indem Sie folgende Parameter übergeben: save(false).

3. Ajax-Überprüfung:

Yii deaktiviert die Ajax-Überprüfung standardmäßig und kann durch Konfigurieren des Parameters „enableAjaxValidation“ auf „true“ aktiviert werden.

客户端设置（两种方式）：

（1）在视图文件ActiveForm中对整个form进行设置：

<?php
$form = ActiveForm::begin([
  &#39;enableAjaxValidation&#39; =>true
]);
?>

（2）在视图文件ActiveField中对单个field进行设置：

<?= $form->field($model, &#39;username&#39;, [&#39;enableAjaxValidation&#39;=>false])->label(&#39;用户名&#39;) ?>

优先级：（2）>（1）

服务器端处理：

if(Yii::$app->request->isAjax) {
    $res = \yii\bootstrap\ActiveForm::validate($model);
    Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;
    return $res;
}

注：有些验证规则无法使用客户端验证，如：unique、exist等。

三、yii核心验证器

Yii提供了一些核心验证器，可以直接使用，申明格式如下：

['属性名', '验证器名称/类名', ...(一些额外参数设置)]

了解并使用yii的核心验证器会让开发变得简单许多。下面简单对yii核心验证器进行分类介绍。

1. 不进行数据验证的验证器

（1）safe：而是把一个属性标记为安全属性。

['desc', 'safe']

（2）default：给值为空的属性设置默认值。

['add_time', 'default', 'value' => time()]

（3）trim：去除输入值首尾两侧多余空格。

['username', 'trim']

（4）filter：滤镜，对数据进行格式化或一些其他处理后返回。

['phone', 'filter', 'filter' => function($value) {
         ....return $value;
}]

filter: 用于定义滤镜的php回调函数，可以为全局函数名，匿名函数或其他。
skipOnArray：是否在输入为数组时跳过滤镜，默认为false。如果滤镜不能处理数组输入，应该设置为true。

2. 数据类型验证器

（1）boolean：布尔型。

['del', 'boolean', 'trueValue' => true, 'falseValue' => false, 'strict' => true]

trueValue：代表真的值，默认为1。
falseValue：代表假的值，默认为0。
strict：是否要求输入数据必须严格匹配trueValue或falseValue。默认为false。

（2）number：数字。

['salary', 'number']

（3）double：双精度浮点型，等效于number验证器。

['salary','double', 'max' => 99.99, 'min' => 0]

（4）integer：整数。

['age', 'integer']

注：number、double、integer验证器都可以设置min、max参数来限制数字的最大、最小值（含界点）。

（5）string：字符串。

['username', 'string', 'length' => [3, 30]]

length：指定输入字符串的长度限制。
min：字符串最小长度。
max：字符串最大长度。
encoding：字符串的编码方式，不设置则使用应用自身的charset属性值。默认为utf-8。

3. 数据格式验证器

（1）date：日期。

['time', 'date', 'format' => 'php:Y:m:d', 'timestampAttribute' => 'startTime']

format：时间格式，默认为“y-m-d”。
timestampAttribute：将时间转化为时间戳并赋值给某个属性。

（2）email：验证是否符合邮箱地址格式。

['emailAddr', 'email']

（3）ip：验证是否为有效IP地址。

['ip_address', 'ip']

（4）url：网址。

['website', 'url', 'defaultScheme' => 'http']

validSchemes：用于指定哪些URI方案会被视为有效，默认为['http', 'https']。
defaultScheme：若输入值没有对应的方案前缀，会使用的默认URI方案前缀。

（5）match：输入值是否满足某个正则表达式。

['username', 'match', 'pattern' => '/^[a-z]\w*$/i']

pattern：正则表达式。
not：是否对验证结果取反。

4. 数据值验证器

（1）required：必填。

[['username', 'password'], 'required']

requiredValue：所期望的值，若没设置则输入不能为空。
strict：检查输入值时是否检查类型。

（2）captcha：验证码。

['verifyCode', 'captcha', 'caseSensitive' => true, 'captchaAction' => 'site/captcha', 'skipOnEmpty' => false]

caseSensitive：是否大小写敏感，默认为false。
captchaAction：指向用于渲染验证码图片的captcha方法的路由，默认为'site/captcha'。
skipOnEmpty：输入为空时是否跳过验证，默认为false。

（3）compare：比较。

['password', 'compare', 'compareAttribute' => 'conpassword', 'operator' => '==']

compareAttribute：与指定属性值比较的属性名称。
compareValue：与某个常量值比较。
operator：比较操作符。

其中compareAttribute默认在验证属性后面加后缀“_repeat”作为另一个比较属性的名称，operator默认为“==”，即：['password', 'compare']规则表示验证password与password_repeat的值是否相等。

（4）each：验证数组。

['ids', 'each', 'rule' => ['integer']]

（验证数组ids中的每个元素是否都是int类型数据）
rule：定义验证每一个数组元素的验证规则。
allowMessageFromRule：是否使用rule中指定的多个验证规则报错信息，默认为true，若设置为false，则使用“message”参数值作为错误信息。

注：若输入值不是数组则会报错。

（5）exist：存在性。

['cid', 'exist', 'targetClass' => 'app\models\Category', 'targetAttribute' => 'id']

（cid的值是否在AR类对应的id属性中存在，使用场景：当前AR模型关联的数据表的cid字段和Category模型关联的数据表的id字段相关联，所以使用该验证规则验证cid字段的值能否在关联的另一个数据表中找到对应记录）
targetClass：用于查找输入值的目标AR类。
targetAttribute：用于查找输入值的目标属性名称。
filter：检查属性值存在性需要进行数据库查询，该参数设置查询的过滤条件。可以设置为查询条件的字符串或数组，或者function($query)匿名函数。
allowArray：是否允许输入值为数组，默认为false。若设置为true，则数组的每个元素都必须在目标字段中存在。若把targetAttribute设置为多元素数组来验证被测值在多字段中的存在性时，该属性不能设置为true。

（6）unique：唯一性。

['email', 'unique', 'targetClass' => 'app\models\User', 'message' => '{attribute}"{value}"已被注册！', 'on' => 'signup']

除了没有allowArray属性，其他属性都和exist验证器一样。

（7）in：范围。

['sex', 'in', 'range' => [0, 1, 2]]

range：范围值列表。
strict：是否使用严格模式（类型与值都要相同）。
not：是否对验证的结果取反，默认为false。
allowArray：是否接受输入数组，默认为false。

5. 文件验证器

（1）file：文件。

['pcImg', 'file', 'extensions' => ['png', 'jpg', 'gif'], 'maxSize' => 1024*1024]

extensions：可接受上传的文件扩展名列表。
mimeTypes：可接受上传的MIME类型列表。
minSize：文件大小下限。
maxSize：文件大小上限。
maxFiles：上传文件个数上限，默认为1。设置为大于1时输入值必须为数组。
checkExtensionByMimeType：是否通过文件的MIME类型来判断文件扩展，默认为true。

（2）image：图片。

['mbImg', 'image' extensions => 'png, ipg', 'minWidth' => 100, 'minHeight' => 100]

该验证器继承自file验证器，并支持额外属性minWidth、maxWidth、minHeight、maxHeight来设置图片的最小、最大宽度和最小、最大高度。

四、其他验证器

1. 条件式验证：

['state', 'required', 'when' => function($model) {//只在country属性值为'USA'的时候state属性值才不能为空
     return $model->country=='USA';
}]

注：若需要支持客户端验证，则要配置'whenClient'属性。

1. 自定义验证器：

（1）行内验证器：一种以模型方法或匿名函数的形式定义的验证器。

示例：

['conpassword', function($attribute, $params) {
     if($this->$attribute != $this->newpassword) {
        $this->addError($attribute, '确认密码和新密码不一致！');
    }
}]。

（当然这里也可以使用yii核心验证器'compare'来实现）

注：行内验证器不支持客户端验证。

（2）独立验证器：

独立验证器是继承自yii\validators\Validator或其子类的类，可以通过重写validateAttribute()方法来实现验证规则，若验证失败，可以调用yii\base\Model::addError()方法来保存错误信息到模型内。

独立验证器示例：

namespace app\components;
use yii\validators\Validator;
class ConpasswordValidator extends Validator {
     public function init() {
         parent::init();
         $this->message = '确认密码和密码不一致！';
     }
     //服务器端验证
     public function validateAttribute($model, $attribute) {
         if($model->conpassword !== $model->password) {
              $model->addError($attribute, $this->message);
         }
     }
     //客户端验证
     public function clientValidateAttribute($model, $attribute, $view) {
         $conpassword = json_encode($model->conpassword);
         $message = json_encode($this->message, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
     return <<<JS
if(value != $conpassword) {
     message.push($message);
}
JS;
         return false;
     }
}

模型中使用示例：

['conpassword', 'app\components\ConpasswordValidator']

最后要注意，验证规则申明的先后顺序对验证结果也是有影响的！

相信看了本文案例你已经掌握了方法，更多精彩请关注php中文网其它相关文章！

推荐阅读：

php使用curl仿制ip与refer步骤详解

Detaillierte Erläuterung des Falles eines kontrollierbaren gleichzeitigen asynchronen Betriebs mithilfe der PHP-Curl-Stapelverarbeitung

Das obige ist der detaillierte Inhalt vonAusführliche Erläuterung zur Verwendung der Yii2-Framework-Datenüberprüfung. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!