mirror of
https://github.com/yiisoft/yii2.git
synced 2025-08-26 14:26:54 +08:00
small translation fixes
This commit is contained in:
@ -53,8 +53,8 @@ public function rules()
|
||||
[[yii\captcha\Captcha|CAPTCHA]].
|
||||
|
||||
- `caseSensitive`: необходимо ли учитывать чувствительность к регистру при сравнении. По умолчанию - false.
|
||||
- `captchaAction`: [маршрут](structure-controllers.md#routes) соответствующий
|
||||
[[yii\captcha\CaptchaAction|CAPTCHA действию]], который рендерит изображение с *CAPTCHA*. По умолчанию - `'site/captcha'`.
|
||||
- `captchaAction`: [маршрут](structure-controllers.md#routes), соответствующий
|
||||
[[yii\captcha\CaptchaAction|CAPTCHA action]], который рендерит изображение с *CAPTCHA*. По умолчанию - `'site/captcha'`.
|
||||
- `skipOnEmpty`: может ли валидация быть пропущена, если *input* пустой. По умолчанию - false,
|
||||
что означает, что *input* обязателен.
|
||||
|
||||
@ -75,13 +75,13 @@ public function rules()
|
||||
соответствует описанному в свойстве `operator`.
|
||||
|
||||
- `compareAttribute`: имя атрибута, с которым нужно сравнить значение. Когда валидатор используется
|
||||
для проверки атрибута, значением по умолчанию для этого свойства будет имя атрибута
|
||||
для проверки атрибута, значением по умолчанию для этого свойства будет имя этого же атрибута
|
||||
с суффиксом `_repeat`. Например, если проверяющийся атрибут - `password`,
|
||||
то значение свойства по умолчанию будет `password_repeat`.
|
||||
- `compareValue`: постоянное значение, с которым будут сравниваться входящие данные. Когда одновременно указаны
|
||||
это свойство и `compareAttribute`, это свойство получит приоритет.
|
||||
- `operator`: оператор сравнения. По умолчанию `==`, что означает проверку на эквивалентность входящих данных и
|
||||
`compareAttribute` и `compareValue`. Поддерживаются следующие операторы:
|
||||
- `operator`: оператор сравнения. По умолчанию `==`, что означает проверку на эквивалентность входящих данных и в
|
||||
`compareAttribute`, и в `compareValue`. Поддерживаются следующие операторы:
|
||||
* `==`: проверяет два значения на эквивалентность. Сравнение не учитывает тип данных.
|
||||
* `===`: проверяет два значения на эквивалентность. Сравнение строгое и учитывает тип данных.
|
||||
* `!=`: проверяет, что два значения не эквивалентны. Сравнение не учитывает тип данных.
|
||||
@ -103,10 +103,10 @@ public function rules()
|
||||
Опционально, он может конвертировать входящее значение в UNIX timestamp и сохранить в атрибуте,
|
||||
описанном здесь: [[yii\validators\DateValidator::timestampAttribute|timestampAttribute]].
|
||||
|
||||
- `format`: формат даты/времени, согласно которому должна быть сделана проверка. Чтобы узнать больше деталей
|
||||
о строке форматирования, пожалуйста, посмотрите [руководство PHP по date_create_from_format()](http://www.php.net/manual/ru/datetime.createfromformat.php)
|
||||
- `format`: формат даты/времени, согласно которому должна быть сделана проверка. Чтобы узнать больше о формате
|
||||
строки, пожалуйста, посмотрите [руководство PHP по date_create_from_format()](http://www.php.net/manual/ru/datetime.createfromformat.php)
|
||||
Значением по умолчанию является `'Y-m-d'`.
|
||||
- `timestampAttribute`: имя атрибута, к которому этот валидатор может передать UNIX timestamp, конвентированный
|
||||
- `timestampAttribute`: имя атрибута, которому этот валидатор может передать UNIX timestamp, конвентированный
|
||||
из строки даты/времени.
|
||||
|
||||
|
||||
@ -127,11 +127,11 @@ public function rules()
|
||||
]
|
||||
```
|
||||
|
||||
Этот валидатор не проверяет данные. Вместо этого он присваивает значения по умолчанию атрибутам, проходящим
|
||||
валидацию, если эти атрибуты пусты.
|
||||
Этот валидатор не проверяет данные. Вместо этого он присваивает значения по умолчанию проходящим проверку
|
||||
атрибутам, если они пусты.
|
||||
|
||||
- `value`: значение по умолчанию или функция обратного вызова PHP, которая возвращает значение по умолчанию,
|
||||
которое будет присвоино проверяемому атрибуту, если он пустой. Функция обратного вызова должна выглядеть так:
|
||||
- `value`: значение по умолчанию или функция обратного вызова, которая возвращает значение по умолчанию,
|
||||
которое будет присвоено проверяемому атрибуту, если он пустой. Функция обратного вызова должна выглядеть так:
|
||||
|
||||
```php
|
||||
function foo($model, $attribute) {
|
||||
@ -154,7 +154,7 @@ function foo($model, $attribute) {
|
||||
```
|
||||
|
||||
Этот валидатор проверяет, что входящее значение является корректным *double* числом. Он идентичен
|
||||
валидатору [number](#number).
|
||||
валидатору [number](#number). (Прим. пер.: корректным float числом).
|
||||
|
||||
- `max`: верхний лимит (включительно) для значений. Если не установлен, значит, валидатор не будет проверять верхний лимит.
|
||||
- `min`: Нижний лимит (включительно) для значений. Если не установлен, валидатор не будет проверять нижний лимит.
|
||||
@ -197,7 +197,7 @@ function foo($model, $attribute) {
|
||||
// a1 требует проверки существования a2 и a3 (используя значение a1)
|
||||
['a1', 'exist', 'targetAttribute' => ['a2', 'a1' => 'a3']],
|
||||
|
||||
// a1 должен существовать. Если a1 является массивом, тогда каждый его элемент должен существовать
|
||||
// a1 должен существовать. Если a1 - массив, то каждый его элемент должен существовать
|
||||
['a1', 'exist', 'allowArray' => true],
|
||||
]
|
||||
```
|
||||
@ -205,16 +205,16 @@ function foo($model, $attribute) {
|
||||
Этот валидатор ищет входящие данные в столбце таблицы. Он работает только с атрибутами
|
||||
модели [Active Record](db-active-record.md). Он поддерживает проверку и одного столбца, и нескольких.
|
||||
|
||||
- `targetClass`: имя класса [Active Record](db-active-record.md), который должен будет быть использован для проверки
|
||||
- `targetClass`: имя класса [Active Record](db-active-record.md), который должен быть использован для проверки
|
||||
входящего значения. Если не установлен, будет использован класс текущей модели.
|
||||
- `targetAttribute`: имя атрибута в `targetClass` который должен быть использован для проверки существования
|
||||
входящего значения. Если не установлен, будет использовано имя атрибута, который валидируется в данный момент.
|
||||
входящего значения. Если не установлен, будет использовано имя атрибута, который проверяется в данный момент.
|
||||
Вы можете использовать массив для валидации нескольких столбцов одновременно. Значения массива являются атрибутами,
|
||||
которые будут использованы для проверки существования, тогда как ключи массива будут являться атрибутами, чьи значения
|
||||
будут проверены. Если ключ и значения одинаковы, вы можете указать только значение.
|
||||
- `filter`: дополнительный фильтр, который будет добавлен к запросу в базу данных для проверки на существование значения.
|
||||
Это может быть строка или массив, представляющие дополнительные условия в запросе (подробнее о формате
|
||||
значений запроса [[yii\db\Query::where()]]), или анонимной функцией с сигнатурой `function ($query)`,
|
||||
значений запроса: [[yii\db\Query::where()]]), или анонимная функция с сигнатурой `function ($query)`,
|
||||
где `$query` - это [[yii\db\Query|Query]] объект, который вы можете модифицировать в функции.
|
||||
- `allowArray`: разрешать ли значению быть массивом. По умолчанию - false. Если свойство установлено в true
|
||||
и тип входящих данных - массив, тогда каждый его элемент должен существовать в соответствующем столбце таблицы.
|
||||
@ -232,7 +232,7 @@ function foo($model, $attribute) {
|
||||
]
|
||||
```
|
||||
|
||||
Этот валидатор проверяет, что проверяемый *input* является корректным загруженным файлом.
|
||||
Этот валидатор проверяет, что input является корректным загруженным файлом.
|
||||
|
||||
- `extensions`: список имен расширений, которые допустимы для загрузки. Это также может быть или массив, или
|
||||
строка, содержащая имена файловых расширений, разделенных пробелом или запятой (пр.: "gif, jpg").
|
||||
@ -246,7 +246,7 @@ function foo($model, $attribute) {
|
||||
- `maxSize`: максимальный размер файла в байтах, разрешенный для загрузки. По умолчанию - null, что значит, что нет
|
||||
максимального лимита.
|
||||
- `maxFiles`: максимальное количество файлов, которое может быть передано в атрибут. По умолчанию 1, что значит, что
|
||||
инпут должен быть файлом в единственном экземпляре. Если больше, чем 1, то атрибут должен быть массивом,
|
||||
input должен быть файлом в единственном экземпляре. Если больше, чем 1, то атрибут должен быть массивом,
|
||||
состоящим из не более, чем `maxFiles` загруженных файлов.
|
||||
- `checkExtensionByMimeType`: нужно ли проверять расширение файла исходя из его MIME-типа. Если они не соответствуют
|
||||
друг другу, то файл будет считаться некорректным. По умолчанию - true, то есть проверка будет произведена.
|
||||
@ -270,7 +270,7 @@ function foo($model, $attribute) {
|
||||
]
|
||||
```
|
||||
|
||||
Этот валидатор не валидирует данные. Вместо этого он применяет указанный фильтр к входящему значению и
|
||||
Этот валидатор не проверяет данные. Вместо этого он применяет указанный фильтр к входящему значению и
|
||||
присваивает результат применения фильтра атрибуту.
|
||||
|
||||
- `filter`: PHP-callback, осуществляющий фильтрацию. Это может быть глобальная php функция, анонимная функция
|
||||
@ -316,9 +316,9 @@ function foo($model, $attribute) {
|
||||
Этот валидатор проверяет, что вхоящее значение соответствует одному из значений, указанных в `range`.
|
||||
|
||||
- `range`: список значений, с которыми будет сравниваться входящее значение.
|
||||
- `strict`: должно ли сравнение входящего значения со списком значений быть строгим (учитывать тип данных)
|
||||
- `strict`: должно ли сравнение входящего значения со списком значений быть строгим (учитывать тип данных).
|
||||
По умолчанию false.
|
||||
- `not`: должен ли результат валидации быть инвертирован. По умолчанию - false. Если свойство установлено в true,
|
||||
- `not`: должен ли результат проверки быть инвертирован. По умолчанию - false. Если свойство установлено в true,
|
||||
валидатор проверяет, что входящее значение НЕ соответсвует ни одному из значений, указанных в `range`.
|
||||
- `allowArray`: устанавливает, допустимо ли использовать массив в качестве входных данных. Если установлено в true
|
||||
и входящие данные являются массивом, для каждого элемента входящего массива должно быть найдено соответствие в
|
||||
@ -344,8 +344,8 @@ function foo($model, $attribute) {
|
||||
|
||||
```php
|
||||
[
|
||||
// проверяет, что "username" начинается с буквы и содержит только буквенные символы, цифровые и
|
||||
// знак подчеркивания
|
||||
// проверяет, что "username" начинается с буквы и содержит только буквенные символы,
|
||||
// числовые символы и знак подчеркивания
|
||||
['username', 'match', 'pattern' => '/^[a-z]\w*$/i']
|
||||
]
|
||||
```
|
||||
@ -354,8 +354,8 @@ function foo($model, $attribute) {
|
||||
|
||||
- `pattern`: регулярное выражение, с которым должно совпадать входящее значение. Это свойство должно быть установлено,
|
||||
иначе будет выброшено исключение.
|
||||
- `not`: инвертирует регулярное выражение. По умолчанию false, что значит, что валидация будет успешна
|
||||
только если входящее значение совпадают с шаблоном. Если установлено в true, валидация будет успешна
|
||||
- `not`: инвертирует регулярное выражение. По умолчанию false, что значит, что валидация будет успешна,
|
||||
только если входящее значение совпадают с шаблоном. Если установлено в true, валидация будет успешна,
|
||||
только если входящее значение НЕ совпадает с шаблоном.
|
||||
|
||||
|
||||
@ -395,7 +395,7 @@ function foo($model, $attribute) {
|
||||
данных, если это свойство установлено в true.
|
||||
|
||||
> Информация: как определить, является ли значение пустым или нет, подробнее рассказывается
|
||||
в секции [Empty Values](input-validation.md#handling-empty-inputs).
|
||||
в секции [Пустые значения](input-validation.md#handling-empty-inputs).
|
||||
|
||||
|
||||
## [[yii\validators\SafeValidator|safe]] <a name="safe"></a>
|
||||
@ -415,7 +415,7 @@ function foo($model, $attribute) {
|
||||
|
||||
```php
|
||||
[
|
||||
// проверяет, что "username" это страка с длиной от 4 до 24 символов
|
||||
// проверяет, что "username" это строка с длиной от 4 до 24 символов
|
||||
['username', 'string', 'length' => [4, 24]],
|
||||
]
|
||||
```
|
||||
@ -428,10 +428,10 @@ function foo($model, $attribute) {
|
||||
* массив с одним элементом: минимальная длина входящей строки (напр.: `[8]`). Это перезапишет `min`.
|
||||
* массив с двумя элементами: минимальная и максимальная длина входящей строки (напр.: `[8, 128]`).
|
||||
Это перезапишет и `min`, и `max`.
|
||||
- `min`: минимальная длина входящей строки. Если не установлено, то не будет ограничений на минимальную длину.
|
||||
- `min`: минимальная длина входящей строки. Если не установлено, то не будет ограничения на минимальную длину.
|
||||
- `max`: максимальная длина входящей строки. Если не установлено, то не будет ограничения на максимальную длину.
|
||||
- `encoding`: кодировка входящей строки. Если не установлено, будет использовано значение из
|
||||
[[yii\base\Application::charset|charset]], которое по умолачнию установлено в `UTF-8`.
|
||||
[[yii\base\Application::charset|charset]], которое по умолчанию установлено в `UTF-8`.
|
||||
|
||||
|
||||
## [[yii\validators\FilterValidator|trim]] <a name="trim"></a>
|
||||
@ -444,7 +444,7 @@ function foo($model, $attribute) {
|
||||
```
|
||||
|
||||
Этот валидатор не производит проверки данных. Вместо этого он будет обрезать пробелы вокруг входящих данных.
|
||||
Помните, что если вхоядщие данные являются массивом, то они будут проигнорированы этим валидатором.
|
||||
Помните, что если входящие данные являются массивом, то они будут проигнорированы этим валидатором.
|
||||
|
||||
|
||||
## [[yii\validators\UniqueValidator|unique]] <a name="unique"></a>
|
||||
@ -454,10 +454,12 @@ function foo($model, $attribute) {
|
||||
// a1 должен быть уникальным в столбце, который представляет "a1" атрибут
|
||||
['a1', 'unique'],
|
||||
|
||||
// a1 должен быть уникальным, но будет использован столбец a2 для проверки уникальности значения a1
|
||||
// a1 должен быть уникальным, но для проверки на уникальность
|
||||
// будет использован столбец a2
|
||||
['a1', 'unique', 'targetAttribute' => 'a2'],
|
||||
|
||||
// a1 и a2 вместе должны быть уникальны, и они оба будут получать сообщения об ошибке
|
||||
// a1 и a2 вместе должны быть уникальны, и каждый из них
|
||||
// будет получать сообщения об ошибке
|
||||
[['a1', 'a2'], 'unique', 'targetAttribute' => ['a1', 'a2']],
|
||||
|
||||
// a1 и a2 вместе должны быть уникальны, но только a1 будет получать сообщение об ошибке
|
||||
@ -475,16 +477,16 @@ function foo($model, $attribute) {
|
||||
|
||||
- `targetClass`: имя класса [Active Record](db-active-record.md), который должен быть использован
|
||||
для проверки значения во входящих данных. Если не установлен, будет использован класс модели, которая
|
||||
в данный момент проходит валидацию.
|
||||
в данный момент проходит проверку.
|
||||
- `targetAttribute`: имя атрибута в `targetClass`, который должен быть использован для проверки на
|
||||
уникальность входящего значения. Если не установлено, будет использован атрибут, проходящий валидацию
|
||||
уникальность входящего значения. Если не установлено, будет использован атрибут, проверяемый
|
||||
в данный момент.
|
||||
Вы можете использовать массив для проверки нескольких столбцов таблицы на уникальность. Значения массива
|
||||
Вы можете использовать массив для проверки нескольких столбцов таблицы на уникальность. Значения массива -
|
||||
это атрибуты, которые будут использованы для валидации, а ключи массива - это атрибуты, которые предоставляют
|
||||
данные для валидации. Если ключ и значение одинаковые, вы можете указать только значение.
|
||||
- `filter`: дополнительный фильтр, который можно присоединить к запросу в БД, чтобы использовать его при
|
||||
проверке значения на уникальность. Это может быть строка или массив, представляющие дополнительные условия для запроса
|
||||
(см. [[yii\db\Query::where()]] о формате условий в запрсое), или анонимная функция вида `function ($query)`,
|
||||
(см. [[yii\db\Query::where()]] о формате условий в запросе), или анонимная функция вида `function ($query)`,
|
||||
где `$query` это объект [[yii\db\Query|Query]], который вы можете изменить в функции.
|
||||
|
||||
|
||||
@ -501,7 +503,7 @@ function foo($model, $attribute) {
|
||||
Этот валидатор проверяет, что входящее значение является корректным URL.
|
||||
|
||||
- `validSchemes`: массив с указанием на URI-схему, которая должна считаться корректной. По умолчанию
|
||||
`['http', 'https']`, что означает, что и `http`, и `https` URL будут считаться корректными.
|
||||
`['http', 'https']`, что означает, что и `http`, и `https` URI будут считаться корректными.
|
||||
- `defaultScheme`: схема URI, которая будет присоединена к входящим данным, если в них отсутствует URI-схема.
|
||||
По умолчанию null, что значит, что входящие данные не будут изменены.
|
||||
- `enableIDN`: должна ли валидация учитывать IDN (интернационализованные доменные имена).
|
||||
|
Reference in New Issue
Block a user