Class yii\validators\FileValidator

是否检查文件类型（扩展名）和 mime-type 是否符合。 如果 mime-type 得到的扩展名和文件名称扩展名不一致，文件会被认为非法。

可上传的文件扩展名列表。 它可以是一个数组， 或者一个由空格或者逗号分隔的字符串（例如："gif, jpg"）。 扩展名称大小写不敏感，默认为 null ， 代表允许所有的文件扩展名。

参见 $wrongExtension for the customized message for wrong file type.

指定的属性可最多持有的文件数量。 默认为1，代表上传单文件。 你可以设置一个大一点的值，这样允许同时上传多个文件。 设置为 0 意味着同时上传的文件数目没有限制。

注意：同时上传的最大文件数量同样受 max_file_uploads 限制， 其默认值为 20。

参见：

• http://php.net/manual/en/ini.core.php#ini.max-file-uploads
• $tooMany for the customized message when too many files are uploaded.

上传文件的最大字节数， 默认为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 for the customized message for a file that is too big.

一个文件没有被正确上传时的错误消息。

允许被上传的文件 MIME 类型列表。 它可以是一个 MIME 类型字符串数组， 或者一个由空格或者逗号分隔的字符串（例如："text/plain, image/png"）。 可以使用通配符 * 来匹配一组 MIME 类型。 例如：image/* 将会匹配所有以 image/ 开头的 MIME 类型。（例如：image/jpeg, image/png）。 MIME 类型名称大小写不敏感。默认为 null，代表允许所有的 MIME 类型。

参见 $wrongMimeType for the customized message for wrong MIME type.

指定的属性最少持有的文件数量。 默认为0，代表无限制。大一点的值意味着最少那么多的文件应该被上传。

参见 $tooFew for the customized message when too few files are uploaded.

上传文件的最小字节数， 默认为null，代表无限制。

参见 $tooSmall for the customized message for a file that is too small.

The size limit for uploaded files.

当上传文件太大时的错误消息。 你可以在消息中使用下面的这些 token ：

• {attribute}: the attribute name
• {file}: the uploaded file name
• {limit}: the maximum size allowed (see getSizeLimit())
• {formattedLimit}: the maximum size formatted with Formatter::asShortSize()

The error message used if the count of multiple uploads less that minFiles. You may use the following tokens in the message:

• {attribute}: the attribute name
• {limit}: the value of $minFiles

The error message used if the count of multiple uploads exceeds limit. You may use the following tokens in the message:

• {attribute}: the attribute name
• {limit}: the value of $maxFiles

The error message used when the uploaded file is too small. You may use the following tokens in the message:

• {attribute}: the attribute name
• {file}: the uploaded file name
• {limit}: the value of $minSize
• {formattedLimit}: the value of $minSize formatted with [[\yii\i18n\Formatter::asShortSize()|Formatter::asShortSize()]

没有文件被上传的错误消息。 注意：这是校验错误消息。 为了确保文件上传是必须的，你需要设置属性 $skipOnEmpty 值为 false。

The error message used when the uploaded file has an extension name that is not listed in $extensions. You may use the following tokens in the message:

• {attribute}: the attribute name
• {file}: the uploaded file name
• {extensions}: the list of the allowed extensions.

The error message used when the file has an mime type that is not allowed by $mimeTypes property. You may use the following tokens in the message:

• {attribute}: the attribute name
• {file}: the uploaded file name
• {mimeTypes}: the value of $mimeTypes