php/yii2
1
0
Fork 0
mirror of https://github.com/yiisoft/yii2.git synced 2025-08-26 14:26:54 +08:00
Code Issues Packages Projects Releases Wiki Activity

small translation fixes

Browse Source
This commit is contained in:
Dmitry Korolev
2014-08-30 00:25:36 +04:00
parent 4c395751a8
commit 6913410e08
1 changed files with 40 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files

78
docs/guide-ru/tutorial-core-validators.md
View File

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