Класс yii\validators\FileValidator

FileValidator проверяет, является ли атрибут допустимым загруженным файлом.

Обратите внимание, что вам необходимо включить fileinfo расширение PHP.

Открытые свойства

Открытые методы

Защищённые методы

Подробности свойств

$checkExtensionByMimeType общедоступное свойство

Определяет, следует ли проверять тип файла (расширение) с помощью mime-типа. Если расширение, полученное из проверки mime-типа файла, отличается от расширения загруженного файла, файл считается недопустимым.

public boolean $checkExtensionByMimeType = true

$extensions общедоступное свойство

Список разрешённых расширений имён файлов. Может быть массивом или строкой, содержащей имена расширений, разделённые пробелами или запятыми (например, "gif, jpg"). Имена расширений нечувствительны к регистру. По умолчанию равно null, что означает, что все расширения имён файлов разрешены.

См. также $wrongExtension для настраиваемого сообщения о неправильном типе файла.

public array|string $extensions = null

$maxFiles общедоступное свойство

Максимальное количество файлов, которые может содержать данный атрибут. По умолчанию равно 1, что означает загрузку одного файла. Определением большего значения становится возможной многократная загрузка. Установка в значение 0 означает отсутствие ограничения на количество файлов, которые можно загрузить одновременно.

Примечание: Максимальное количество одновременно загружаемых файлов также ограничено директивой PHP max_file_uploads, которая по умолчанию равна 20.

См. также:

• http://php.net/manual/en/ini.core.php#ini.max-file-uploads
• $tooMany для настраиваемого сообщения, когда загружено слишком много файлов.

public integer $maxFiles = 1

$maxSize общедоступное свойство

Максимальное количество байтов, требуемых для загружаемого файла. По умолчанию равно null, что означает отсутствие ограничения. Обратите внимание, что лимит размера также зависит от upload_max_filesize и post_max_size настроек INI и значения скрытого поля 'MAX_FILE_SIZE'. Подробнее см. getSizeLimit().

См. также:

• http://php.net/manual/en/ini.core.php#ini.upload-max-filesize
• http://php.net/post-max-size
• getSizeLimit()
• $tooBig для настраиваемого сообщения о слишком большом файле.

public integer $maxSize = null

$message общедоступное свойство

Сообщение об ошибке, используемое, когда файл загружен неправильно.

public string $message = null

$mimeTypes общедоступное свойство

Список типов MIME файлов, которые разрешено загружать. Это может быть массив или строка, содержащая типы MIME файлов, разделенные пробелами или запятыми (например, "text/plain, image/png"). Для сопоставления групп типов MIME может использоваться маска со специальным символом *. Например, image/* пройдет все типы MIME, начинающиеся с image/ (например, image/jpeg, image/png). Названия типов MIME нечувствительны к регистру. По умолчанию равно null, что означает, что разрешены все типы MIME.

См. также $wrongMimeType для настраиваемого сообщения о неправильном типе MIME.

public array|string $mimeTypes = null

$minSize общедоступное свойство

Минимальное количество байтов, требуемых для загружаемого файла. По умолчанию равно null, что означает отсутствие ограничения.

См. также $tooSmall для настраиваемого сообщения о слишком маленьком файле.

public integer $minSize = null

$sizeLimit общедоступное только для чтения свойство

Лимит размера загружаемых файлов.

public integer getSizeLimit ( )

$tooBig общедоступное свойство

Сообщение об ошибке, используемое, когда загружаемый файл слишком большой. Вы можете использовать следующие токены в сообщении:

• {attribute}: имя атрибута
• {file}: имя загружаемого файла
• {limit}: максимальный разрешенный размер (см. getSizeLimit())
• {formattedLimit}: максимальный размер, отформатированный с помощью Formatter::asShortSize()

public string $tooBig = null

$tooMany общедоступное свойство

Сообщение об ошибке, используемое, если количество многократных загрузок превышает лимит. Вы можете использовать следующие токены в сообщении:

• {attribute}: имя атрибута
• {limit}: значение $maxFiles

public string $tooMany = null

$tooSmall общедоступное свойство

Сообщение об ошибке, используемое, когда загружаемый файл слишком маленький. Вы можете использовать следующие токены в сообщении:

• {attribute}: имя атрибута
• {file}: имя загружаемого файла
• {limit}: значение $minSize
• {formattedLimit}: значение $minSize отформатированное с помощью [[\yii\i18n\Formatter::asShortSize()|Formatter::asShortSize()]

public string $tooSmall = null

$uploadRequired общедоступное свойство

Сообщение об ошибке, используемое, когда файл не загружен. Обратите внимание, что это текст сообщения об ошибке валидации. Чтобы сделать загрузку файлов обязательной, необходимо установить $skipOnEmpty на false.

public string $uploadRequired = null

$wrongExtension общедоступное свойство

Сообщение об ошибке, используемое, когда у загружаемого файла имя расширения не указано в $extensions. Вы можете использовать следующие токены в сообщении:

• {attribute}: имя атрибута
• {file}: имя загружаемого файла
• {extensions}: список разрешенных расширений.

public string $wrongExtension = null

$wrongMimeType общедоступное свойство

Сообщение об ошибке, используемое, когда у файла тип MIME не разрешен свойством $mimeTypes. Вы можете использовать следующие токены в сообщении:

• {attribute}: имя атрибута
• {file}: имя загружаемого файла
• {mimeTypes}: значение $mimeTypes

public string $wrongMimeType = null

Подробное описание методов