Yii Core Validator API, detaillierte Erklärung_php-Beispiel

Die Beispiele in diesem Artikel beschreiben die Yii-Kernvalidator-API. Teilen Sie es als Referenz mit allen. Die Details lauten wie folgt:

Kernvalidatoren

Vorwort

Yii bietet eine Reihe häufig verwendeter Kernvalidatoren, die Sie in
finden Gefunden im yiivalidators-Namespace. Anstatt lange Validator-Klassennamen zu verwenden, können Sie stattdessen Aliase verwenden.

Zum Beispiel können Sie den erforderlichen Alias ​​anstelle der yiivalidatorsRequiredValidator-Klasse verwenden:

<&#63;php
public function rules()
{
  return [
    [['email', 'password'], 'required'],
  ];
}
&#63;>

Die Eigenschaft yiivalidatorsValidator::$builtInValidators vergibt Aliase an alle unterstützten Validatoren.

Als nächstes erklären wir die Verwendung jedes Kernvalidators.

1. Boolescher wahrer oder falscher Wert

<&#63;php
[
  // 检查是否 "selected" 是 0 或 1, 不管数据类型
  ['selected', 'boolean'],
  // 检查是否 "deleted" 是一个 boolean 类型, 只能是 true 或则 false
  ['deleted', 'boolean', 'trueValue' => true, 'falseValue' => false, 'strict' => true],
]
&#63;>

Oben wird geprüft, ob es sich um einen Bool-Wert handelt.

trueValue: stellt den Wert dar, wenn true. Der Standardwert ist „1“.
falseValue: stellt den Wert dar, wenn „false“ ist. Der Standardwert ist „0“.
strict: Ob der Wert im Eingabefeld mit dem eingestellten trueValue und falseValue übereinstimmen muss. Der Standardwert ist false.

Hinweis: Da die über HTML übermittelten Daten zeichenbasiert sind, müssen Sie im Allgemeinen das strikte Attribut auf „false“ setzen.

2. Captcha-Bestätigungscode

<&#63;php
[
  ['verificationCode', 'captcha'],
]
&#63;>

Dieser Validator ist normalerweise derselbe wie
yiicaptchaCaptchaAction und
Wird zusammen mit yiicaptchaCaptcha verwendet, um sicherzustellen, dass dasselbe Captcha über die CAPTCHA-Komponente eingegeben wird.
caseSensitive: Ob beim Bestätigungscode die Groß-/Kleinschreibung beachtet werden muss. Der Standardwert ist false.
captchaAction: Die Standard-CAPTCHA-Aktion des Bestätigungscodes generiert den Pfad des CAPTCHA-Bildes. Der Standardwert ist „site/captcha“.
skipOnEmpty: Ob die Überprüfung übersprungen werden soll, wenn die Eingabe leer ist. Der Standardwert ist false, dh die Eingabe ist erforderlich.

3. vergleichen vergleichen

<&#63;php
[
  // 验证是否 "password" 属性和 "password_repeat"是否相等
  ['password', 'compare'],
  // 验证 age >= 30
  ['age', 'compare', 'compareValue' => 30, 'operator' => '>='],
]
&#63;>

Dieser Validator vergleicht den angegebenen Eingabewert mit einem anderen Wert und stellt sicher, dass zwischen ihnen der angegebene Operator verwendet wird.

compareAttribute: Mit wem der Attributname verglichen wird, um ein Attribut zu überprüfen, wird es mit dem Attribut mit demselben Namen, aber mit dem Suffix _repeat verglichen. Wenn der zu überprüfende Attributname „password“ ist, lautet der Standardattributname für den Vergleich „password_repeat“. Sie können den gewünschten Wert angeben.
compareValue: Ein konstanter Wert im Vergleich zum Eingabewert. Wenn die Attribute „property“ und „compareAttribute“ gleichzeitig angegeben werden, hat dieser Wert Vorrang.
Operator: Der Vergleichsoperator ist ==, d. h. der Eingabewert ist nur dann erfolgreich, wenn er dem Wert „compareAttribute“ oder „compareValue“ entspricht.
Die folgenden Operatoren werden unterstützt: ==, ===, !=, !==, >, >=, <, <=.

4. Datum Datum

<&#63;php
[
  [['from_date', 'to_date'], 'date'],
]
&#63;>

Dieser Validator prüft, ob der Eingabewert ein Datum, eine Uhrzeit oder eine Datums-/Uhrzeitzeit in geeigneter Form ist. Optional kann er den Eingabewert in einen UNIX-Zeitstempel konvertieren, der in einem über timestampAttribute angegebenen Attribut gespeichert ist.

Format: Dieses Datum/diese Uhrzeit ist ein unterstütztes Format

, das in http://php.net/manual/en/datetime.createfromformat.php deklariert ist

Wenn dieser Wert nicht festgelegt ist, nimmt er automatisch den Wert Yii::$app->formatter->dateFormat.
an timestampAttribute: Der Attributname, der zum Speichern des Datums oder der Uhrzeit verwendet wird, die die Transformation eingibt. Kann auch derselbe Attributname sein wie der, der validiert wird. In diesem Fall wird der ursprüngliche Wert überschrieben den Zeitstempel. Sie können sich das Beispiel „Umgang mit DatePicker“ ansehen.
http://www.yiiframework.com/doc-2.0/widget-jui#datepicker-date-input

Wenn die Eingabe optional ist, möchten Sie möglicherweise zusätzlich zur Datumsvalidierung auch einen Standardwertfilter hinzufügen, um sicherzustellen, dass leere Eingaben als NULL gespeichert werden. Andernfalls erhalten Sie möglicherweise Datumsangaben wie 0000-00-00 im Eingabefeld der Datumsauswahl oder 1970-01-01 in Ihrer Datenbank

<&#63;php
[
  [['from_date', 'to_date'], 'default', 'value' => null],
  [['from_date', 'to_date'], 'date'],
],
&#63;>

5.Standardwert

<&#63;php
[
  // 设置 "age" 为 null 如果他是空的
  ['age', 'default', 'value' => null],
  // 设置 "country" 为 "USA" 如果他是空的
  ['country', 'default', 'value' => 'USA'],
  // 分配 "from" 和 "to" 分别加3天和6天, 如果他们是空的话
  [['from', 'to'], 'default', 'value' => function ($model, $attribute) {
    return date('Y-m-d', strtotime($attribute === 'to' &#63; '+3 days' : '+6 days'));
  }],
]
&#63;>

Dieser Validator validiert keine Attributwerte, wenn diese leer sind.

Wert: Der Standardwert des Formulars. Der Funktionsprototyp lautet wie folgt:

<&#63;php
function foo($model, $attribute) {
  // ... 组装 $value ...
  return $value;
}
&#63;>

6. Doppelter Gleitkommawert

<&#63;php
[
  // 检查 "salary" 是一个 double 数字
  ['salary', 'double'],
]
&#63;>

Entspricht einem Zahlenprüfer:

max: die Obergrenze der Anzahl, sie wird nicht überprüft, wenn sie nicht festgelegt ist
min: Die Nummer ist offline und wird nicht überprüft, wenn sie nicht eingestellt ist

7. E-Mail-Bestätigung

<&#63;php
[
  // 检查邮箱是一个有效的 "email"地址
  ['email', 'email'],
]
&#63;>

allowName: 检查名字是否允许在邮箱中出现 (e.g. John Smith ). 默认为 false.
checkDNS，是否检查电子邮件的域名是否存在，是否有任何一个A或MX记录。请注意，这可能检查由于临时DNS问题失败，即使电子邮件地址实际上是有效的。默认为false。
enableIDN，验证过程是否应考虑到IDN（国际化域名）。默认为false。需要注意的是，为了使用IDN验证您必须安装并启用国际PHP扩展，或异常将被抛出。

8. exist 是否存在

<&#63;php
[
  // a1 需要在 属性列中存在 "a1" 这个好像默认就有啊
  ['a1', 'exist'],
  // a1 存在,但它的值将使用A2来检查是否存在
  ['a1', 'exist', 'targetAttribute' => 'a2'],
  // a1 和 a2 需要同时存在, 他们都将接收错误信息
  [['a1', 'a2'], 'exist', 'targetAttribute' => ['a1', 'a2']],
  // a1 和 a2 需要同时存在, 只有 a1 将接收错误信息
  ['a1', 'exist', 'targetAttribute' => ['a1', 'a2']],
  // a1 需要存在 通过检测a2 和 a3 (用 a1 的值)
  ['a1', 'exist', 'targetAttribute' => ['a2', 'a1' => 'a3']],
  // a1 需要存在. 如果 a1是一个数组, 那么每个元素都必须存在.
  ['a1', 'exist', 'allowArray' => true],
]
&#63;>

这个验证器检查输入的值能否被找到在在对应的表的列值里，他只会在 Active Record model 模型的属性里起作用.

他支持验证单列或多列

targetClass: 用来寻找输入值验证的 Active Record 类名. 如果未设置, 默认使用当前设置的模型类.
targetAttribute: 应该用于验证输入值的存在在targetClass的属性的名称。如果没有设置，将使用目前正在验证的属性的名称。可以使用阵列来验证多列的存在的同时。数组的值是将被用于验证存在的属性，而数组键是其值要验证的属性。如果键和值都是一样的，你可以指定值.
filter: additional filter to be applied to the DB query used to check the existence of the input value. This can be a string or an array representing the additional query condition (refer to yii\db\Query::where() on the format of query condition), or an anonymous function with the signature function ($query), where $query is the Query object that you can modify in the function.
allowArray: 是否允许输入的值是一个array.默认 false. 若果属性是 true 而且输入是一个 array, 那么熟这里的每一个元素都必须存在在指向的目标列里. 注意这个属性不能被设置成true 如果你设置验证多列通过设置 targetAttribute 为一个 array.

9. file 文件验证

<&#63;php
[
  // 检查 "primaryImage" 上传的文件格式是 PNG, JPG 或者 GIF
  // the file size must be less than 1MB
  ['primaryImage', 'file', 'extensions' => ['png', 'jpg', 'gif'], 'maxSize' => 1024*1024],
]
&#63;>

检查是否是一个有效的上传文件。

extensions: 允许上传的文件类型列表.他可以是一个数组 或者是一个以逗号分割的字符串(如. "gif, jpg"). 扩展名不区分大小写，默认为 null, 意味着所有的文件扩展名是允许的.
mimeTypes: 允许上传的文件资源的媒体类型。他可以是一个数组 或者是一个以逗号或空格分割的字符串 (如. "image/jpeg, image/png"). 不区分大小写，默认为 null, 意味着所有的文件扩展名是允许的.
minSize: 上传文件的最小字节数 未设不做判断.
maxSize: 上传文件的最大字节数 未设不做判断.
maxFiles: 最大的上传文件数 默认为 1, 意味着只能上传单个文件对于单个文件上传框. 如果大于 1, 那么 input必须是一个 array 包含至多 maxFiles 数量的上传文件.
checkExtensionByMimeType: 是否检查文件的扩展名. 如果由MIME类型检查所产生的扩展不同于上传的文件扩展名，该文件将被认为是无效的。默认值为true，意思进行这样的检查。
FileValidator 和 yii\web\UploadedFile 一起使用. .

文件上传请参考：http://www.yiiframework.com/doc-2.0/guide-input-file-upload.html

10. filter 过滤

<&#63;php
[
  // 去掉 "username" 和 "email" 输入空格 跳过数组验证
  [['username', 'email'], 'filter', 'filter' => 'trim', 'skipOnArray' => true],
  // 验证正常 "phone" 输入
  ['phone', 'filter', 'filter' => function ($value) {
    // 验证正确性手机代码
    return $value;
  }],
]
&#63;>

这个验证器验证不了数据. 相反的, it applies a filter on the input value and assigns it back to the attribute being validated.

filter: 一个php回调函数定义一个filter. 他可能是一个全局函数的名字, 一个匿名函数等等. 函数的原型一定是<?php function ($value) { return $newValue; } ?>这个属性必须设置.

skipOnArray: 当输入只是一个数组的时候是否跳过.默认是 false. 请注意，如果过滤器无法处理数组输入，您应该将此属性设置为true。否则，可能会发生一些PHP错误.

小提示: 去空格直接用trim验证.

小提示: 部分封装可以直接使用系统函数如intval:

<&#63;php
['property', 'filter', 'filter' => 'boolval'],
['property', 'filter', 'filter' => 'intval'],
&#63;>

11. image 图片

<&#63;php
[
  // 检查 "primaryImage" 是否是一个有效的图片 且大小合适
  ['primaryImage', 'image', 'extensions' => 'png, jpg',
    'minWidth' => 100, 'maxWidth' => 1000,
    'minHeight' => 100, 'maxHeight' => 1000,
  ],
]
&#63;>

文件验证器的扩展:

minWidth: 最小的宽度 不设无限制.
maxWidth: 最大的宽度 不设无限制.
minHeight: 最小的高度 不设无限制.
maxHeight: 最大的高度 不设无限制.

12. in 在那一个数组里面的值

<&#63;php
[
  // 检查 "level" 是 1, 2 或 3
  ['level', 'in', 'range' => [1, 2, 3]],
]
&#63;>

检查输入的值是否存在于给定的系列值的列表中.

range: 给定范围值的列表.
strict: 输入值和给定值之间的比较结果是否应严格（的类型和值必须相同）。默认为false。
not: 验证结果是否应该被反转。默认为false。当此属性设置为true，验证检查，输入的值不能是给定列表的值中.
allowArray: 是否允许输入值是一个数组。如果这是真的，并输入值是一个数组，数组中的每个元素必须值的给定列表中找到，或验证会失败。

13. integer 整型验证

<&#63;php
[
  // 检查 "age" 是一个整型值
  ['age', 'integer'],
]
&#63;>

max: 上限 不设不检查.
min: 下限 不设不检查..

14. match 正则匹配检查

<&#63;php
[
  // 检查 "username" 以字母开头，并且只包含文字字符
  ['username', 'match', 'pattern' => '/^[a-z]\w*$/i']
]
&#63;>

输入值指定的正则表达式匹配验证检查.

pattern: 输入值必须匹配的规则. 属性必须设置,否则将会抛出异常.
not: 是否反转验证结果. 默认 false.

15. number 数字检查

<&#63;php
[
  // 检查 "salary" 是一个数字
  ['salary', 'number'],
]
&#63;>

相当于double验证器.

max: 上限 不设不检查.
min: 下限 不设不检查.

16. required 是否为空检查

<&#63;php
[
  // 检查 "username" 和 "password" 不是空的
  [['username', 'password'], 'required'],
]
&#63;>

该验证器阻止用户提交空的表单数据.

requiredValue: 应该输入的值. 如果未设 意味着输入值 不应该为空.
strict: 验证一个值时是否应该检查数据类型. 默认false.当 requiredValue未设置时,如果这个属性是 true, 验证器会检查输入值不严格null;如果改属性false,验证器将使用一个松散的规则来确定一个值是空的或不. 当 requiredValue设置了,输入和requiredValue之间的比较也将检查数据类型，如果此属性为true。

17. safe 标记输入是安全属性

<&#63;php
[
  // 标记 "description" 是一个 safe 的属性
  ['description', 'safe'],
]
&#63;>

这个验证器不会执行数据验证.相反, 它是用来标记的属性是一个安全属性(我猜作用是不会进行字符转义吧)。

18. string 字符串验证

<&#63;php
[
  // 检查 "username"是一个 string 而且长度在 4 和 24 之间
  ['username', 'string', 'length' => [4, 24]],
]
&#63;>

这个验证器检查输入的值是一个字符串且长度在确定的值的范围里。

length: 指定待验证的字符串的长度. 可以指定以下形式:
一个整数: 字符串的精确长度;
单个数组元素: 输入的最小长度 (e.g. [8]). 必须超过或等于这个数
两个数组元素: 输入的最小长度和最大长度 (e.g. [8, 128]).
min: 输入字符串的最小长度 未设不限制.
max: 输入字符串的最大长度 未设不限制..
encoding: 输入字符串的编码 未设默认 UTF-8.

19. trim 去空格

<&#63;php
[
  // 去掉 "username" 和 "email" 两边的空格
  [['username', 'email'], 'trim'],
]
&#63;>

不进行数据验证 只进行去空格 如果属性是一个数组 将会自动忽略此过滤.

20. unique 唯一性验证

<&#63;php
[
  // a1 需要是在由“a1”属性表示的列中的唯一
  ['a1', 'unique'],
  // a1 必须是唯一的，但列a2将用于检查的a1值的唯一性
  ['a1', 'unique', 'targetAttribute' => 'a2'],
  // a1和a2的需要是唯一的，并且它们都将收到错误消息
  [['a1', 'a2'], 'unique', 'targetAttribute' => ['a1', 'a2']],
  // a1和a2的需要是唯一的，只有a1将收到错误消息
  ['a1', 'unique', 'targetAttribute' => ['a1', 'a2']],
  // a1需要通过检查的两个a2和a3的唯一性（使用a1的值）是唯一的
  ['a1', 'unique', 'targetAttribute' => ['a2', 'a1' => 'a3']],
]
&#63;>

这验证检查，如果输入的值是表列中的唯一。它仅适用于活动记录模型的属性。它支持验证对任何单个列或多个列。

targetClass: 应该是被用于验证查找输入值的活动记录类的名字。如果没有设置，将要使用的类目前正在验证该模型的.
targetAttribute: 应该用来验证输入值的唯一性在targetClass的属性的名称。如果没有设置，将使用目前正在验证的属性的名称。可以使用阵列来验证多列的唯一性的同时。数组的值是将被用于验证唯一性的属性，而数组键是其值要验证的属性。如果键和值都是一样的，你可以指定的值。
filter: a额外的过滤器被应用到用于检查输入值的唯一性的数据库查询。这可以是一个字符串或代表附加查询条件的数组(参考 yii\db\Query::where() 查询条件的格式), 或者是一个匿名函数像： function ($query), 其中$query是你可以在函数修改查询对象。
http://www.yiiframework.com/doc-2.0/yii-db-query.html#where()-detail

21. url 地址验证

<&#63;php
[
  // 检查 "website" 是一个有效的 URL. 前置 "http://" 到 "website" 属性
  // 如果它不具有一个URI模式
  ['website', 'url', 'defaultScheme' => 'http'],
]
&#63;>

validSchemes: 一个数组指定URI方案应被认为有效。默认为['HTTP'，'HTTPS']，意思是HTTP和HTTPS URL被认为是有效的。
defaultScheme: 默认URI方案要预先考虑到输入，如果它不具有方案的一部分。默认为null，意味着不修改输入值。
enableIDN：验证是否应考虑到IDN（国际化域名）。默认为false。需要注意的是，为了使用IDN验证您必须安装并启用国际PHP扩展，否则异常将会被抛出。

更多关于Yii相关内容感兴趣的读者可查看本站专题：《Yii框架入门及常用技巧总结》、《php优秀开发框架总结》、《smarty模板入门基础教程》、《php面向对象程序设计入门教程》、《php字符串(string)用法总结》、《php+mysql数据库操作入门教程》及《php常见数据库操作技巧汇总》

希望本文所述对大家基于Yii框架的PHP程序设计有所帮助。