Completed
Push — 2.1 ( ac167c...b997fd )
by Alexander
21:40 queued 07:46
created

FileValidator::clientValidateAttribute()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 6
Code Lines 4

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 0
CRAP Score 2

Importance

Changes 0
Metric Value
dl 0
loc 6
rs 9.4285
c 0
b 0
f 0
ccs 0
cts 4
cp 0
cc 1
eloc 4
nc 1
nop 3
crap 2
1
<?php
2
/**
3
 * @link http://www.yiiframework.com/
4
 * @copyright Copyright (c) 2008 Yii Software LLC
5
 * @license http://www.yiiframework.com/license/
6
 */
7
8
namespace yii\validators;
9
10
use Yii;
11
use yii\helpers\FileHelper;
12
use yii\helpers\Html;
13
use yii\helpers\Json;
14
use yii\web\JsExpression;
15
use yii\http\UploadedFile;
16
17
/**
18
 * FileValidator verifies if an attribute is receiving a valid uploaded file.
19
 *
20
 * Note that you should enable `fileinfo` PHP extension.
21
 *
22
 * @property int $sizeLimit The size limit for uploaded files. This property is read-only.
23
 *
24
 * @author Qiang Xue <[email protected]>
25
 * @since 2.0
26
 */
27
class FileValidator extends Validator
28
{
29
    /**
30
     * @var array|string a list of file name extensions that are allowed to be uploaded.
31
     * This can be either an array or a string consisting of file extension names
32
     * separated by space or comma (e.g. "gif, jpg").
33
     * Extension names are case-insensitive. Defaults to null, meaning all file name
34
     * extensions are allowed.
35
     * @see wrongExtension for the customized message for wrong file type.
36
     */
37
    public $extensions;
38
    /**
39
     * @var bool whether to check file type (extension) with mime-type. If extension produced by
40
     * file mime-type check differs from uploaded file extension, the file will be considered as invalid.
41
     */
42
    public $checkExtensionByMimeType = true;
43
    /**
44
     * @var array|string a list of file MIME types that are allowed to be uploaded.
45
     * This can be either an array or a string consisting of file MIME types
46
     * separated by space or comma (e.g. "text/plain, image/png").
47
     * The mask with the special character `*` can be used to match groups of mime types.
48
     * For example `image/*` will pass all mime types, that begin with `image/` (e.g. `image/jpeg`, `image/png`).
49
     * Mime type names are case-insensitive. Defaults to null, meaning all MIME types are allowed.
50
     * @see wrongMimeType for the customized message for wrong MIME type.
51
     */
52
    public $mimeTypes;
53
    /**
54
     * @var int the minimum number of bytes required for the uploaded file.
55
     * Defaults to null, meaning no limit.
56
     * @see tooSmall for the customized message for a file that is too small.
57
     */
58
    public $minSize;
59
    /**
60
     * @var int the maximum number of bytes required for the uploaded file.
61
     * Defaults to null, meaning no limit.
62
     * Note, the size limit is also affected by `upload_max_filesize` and `post_max_size` INI setting
63
     * and the 'MAX_FILE_SIZE' hidden field value. See [[getSizeLimit()]] for details.
64
     * @see http://php.net/manual/en/ini.core.php#ini.upload-max-filesize
65
     * @see http://php.net/post-max-size
66
     * @see getSizeLimit
67
     * @see tooBig for the customized message for a file that is too big.
68
     */
69
    public $maxSize;
70
    /**
71
     * @var int the maximum file count the given attribute can hold.
72
     * Defaults to 1, meaning single file upload. By defining a higher number,
73
     * multiple uploads become possible. Setting it to `0` means there is no limit on
74
     * the number of files that can be uploaded simultaneously.
75
     *
76
     * > Note: The maximum number of files allowed to be uploaded simultaneously is
77
     * also limited with PHP directive `max_file_uploads`, which defaults to 20.
78
     *
79
     * @see http://php.net/manual/en/ini.core.php#ini.max-file-uploads
80
     * @see tooMany for the customized message when too many files are uploaded.
81
     */
82
    public $maxFiles = 1;
83
    /**
84
     * @var string the error message used when a file is not uploaded correctly.
85
     */
86
    public $message;
87
    /**
88
     * @var string the error message used when no file is uploaded.
89
     * Note that this is the text of the validation error message. To make uploading files required,
90
     * you have to set [[skipOnEmpty]] to `false`.
91
     */
92
    public $uploadRequired;
93
    /**
94
     * @var string the error message used when the uploaded file is too large.
95
     * You may use the following tokens in the message:
96
     *
97
     * - {attribute}: the attribute name
98
     * - {file}: the uploaded file name
99
     * - {limit}: the maximum size allowed (see [[getSizeLimit()]])
100
     * - {formattedLimit}: the maximum size formatted
101
     *   with [[\yii\i18n\Formatter::asShortSize()|Formatter::asShortSize()]]
102
     */
103
    public $tooBig;
104
    /**
105
     * @var string the error message used when the uploaded file is too small.
106
     * You may use the following tokens in the message:
107
     *
108
     * - {attribute}: the attribute name
109
     * - {file}: the uploaded file name
110
     * - {limit}: the value of [[minSize]]
111
     * - {formattedLimit}: the value of [[minSize]] formatted
112
     *   with [[\yii\i18n\Formatter::asShortSize()|Formatter::asShortSize()]
113
     */
114
    public $tooSmall;
115
    /**
116
     * @var string the error message used if the count of multiple uploads exceeds limit.
117
     * You may use the following tokens in the message:
118
     *
119
     * - {attribute}: the attribute name
120
     * - {limit}: the value of [[maxFiles]]
121
     */
122
    public $tooMany;
123
    /**
124
     * @var string the error message used when the uploaded file has an extension name
125
     * that is not listed in [[extensions]]. You may use the following tokens in the message:
126
     *
127
     * - {attribute}: the attribute name
128
     * - {file}: the uploaded file name
129
     * - {extensions}: the list of the allowed extensions.
130
     */
131
    public $wrongExtension;
132
    /**
133
     * @var string the error message used when the file has an mime type
134
     * that is not allowed by [[mimeTypes]] property.
135
     * You may use the following tokens in the message:
136
     *
137
     * - {attribute}: the attribute name
138
     * - {file}: the uploaded file name
139
     * - {mimeTypes}: the value of [[mimeTypes]]
140
     */
141
    public $wrongMimeType;
142
143
144
    /**
145
     * @inheritdoc
146
     */
147 36
    public function init()
148
    {
149 36
        parent::init();
150 36
        if ($this->message === null) {
151 36
            $this->message = Yii::t('yii', 'File upload failed.');
152
        }
153 36
        if ($this->uploadRequired === null) {
154 36
            $this->uploadRequired = Yii::t('yii', 'Please upload a file.');
155
        }
156 36
        if ($this->tooMany === null) {
157 36
            $this->tooMany = Yii::t('yii', 'You can upload at most {limit, number} {limit, plural, one{file} other{files}}.');
158
        }
159 36
        if ($this->wrongExtension === null) {
160 36
            $this->wrongExtension = Yii::t('yii', 'Only files with these extensions are allowed: {extensions}.');
161
        }
162 36
        if ($this->tooBig === null) {
163 36
            $this->tooBig = Yii::t('yii', 'The file "{file}" is too big. Its size cannot exceed {formattedLimit}.');
164
        }
165 36
        if ($this->tooSmall === null) {
166 36
            $this->tooSmall = Yii::t('yii', 'The file "{file}" is too small. Its size cannot be smaller than {formattedLimit}.');
167
        }
168 36
        if (!is_array($this->extensions)) {
169 23
            $this->extensions = preg_split('/[\s,]+/', strtolower($this->extensions), -1, PREG_SPLIT_NO_EMPTY);
170
        } else {
171 15
            $this->extensions = array_map('strtolower', $this->extensions);
172
        }
173 36
        if ($this->wrongMimeType === null) {
174 36
            $this->wrongMimeType = Yii::t('yii', 'Only files with these MIME types are allowed: {mimeTypes}.');
175
        }
176 36
        if (!is_array($this->mimeTypes)) {
177 36
            $this->mimeTypes = preg_split('/[\s,]+/', strtolower($this->mimeTypes), -1, PREG_SPLIT_NO_EMPTY);
178
        } else {
179 1
            $this->mimeTypes = array_map('strtolower', $this->mimeTypes);
180
        }
181 36
    }
182
183
    /**
184
     * @inheritdoc
185
     */
186 7
    public function validateAttribute($model, $attribute)
187
    {
188 7
        if ($this->maxFiles != 1) {
189 1
            $files = $model->$attribute;
190 1
            if (!is_array($files)) {
191 1
                $this->addError($model, $attribute, $this->uploadRequired);
192
193 1
                return;
194
            }
195 1
            foreach ($files as $i => $file) {
196 1
                if (!$file instanceof UploadedFile || $file->error == UPLOAD_ERR_NO_FILE) {
197 1
                    unset($files[$i]);
198
                }
199
            }
200 1
            $model->$attribute = $files;
201 1
            if (empty($files)) {
202 1
                $this->addError($model, $attribute, $this->uploadRequired);
203
            }
204 1
            if ($this->maxFiles && count($files) > $this->maxFiles) {
205 1
                $this->addError($model, $attribute, $this->tooMany, ['limit' => $this->maxFiles]);
206
            } else {
207 1
                foreach ($files as $file) {
208 1
                    $result = $this->validateValue($file);
209 1
                    if (!empty($result)) {
210 1
                        $this->addError($model, $attribute, $result[0], $result[1]);
211
                    }
212
                }
213
            }
214
        } else {
215 7
            $result = $this->validateValue($model->$attribute);
216 7
            if (!empty($result)) {
217 7
                $this->addError($model, $attribute, $result[0], $result[1]);
218
            }
219
        }
220 7
    }
221
222
    /**
223
     * @inheritdoc
224
     */
225 31
    protected function validateValue($value)
226
    {
227 31
        if (!$value instanceof UploadedFile || $value->getError() == UPLOAD_ERR_NO_FILE) {
228 1
            return [$this->uploadRequired, []];
229
        }
230
231 31
        switch ($value->error) {
232 31
            case UPLOAD_ERR_OK:
233 27
                if ($this->maxSize !== null && $value->size > $this->getSizeLimit()) {
234
                    return [
235 1
                        $this->tooBig,
236
                        [
237 1
                            'file' => $value->getClientFilename(),
238 1
                            'limit' => $this->getSizeLimit(),
239 1
                            'formattedLimit' => Yii::$app->formatter->asShortSize($this->getSizeLimit()),
240
                        ],
241
                    ];
242 27
                } elseif ($this->minSize !== null && $value->size < $this->minSize) {
243
                    return [
244 1
                        $this->tooSmall,
245
                        [
246 1
                            'file' => $value->getClientFilename(),
247 1
                            'limit' => $this->minSize,
248 1
                            'formattedLimit' => Yii::$app->formatter->asShortSize($this->minSize),
249
                        ],
250
                    ];
251 27
                } elseif (!empty($this->extensions) && !$this->validateExtension($value)) {
252 7
                    return [$this->wrongExtension, ['file' => $value->getClientFilename(), 'extensions' => implode(', ', $this->extensions)]];
253 22
                } elseif (!empty($this->mimeTypes) && !$this->validateMimeType($value)) {
254 5
                    return [$this->wrongMimeType, ['file' => $value->getClientFilename(), 'mimeTypes' => implode(', ', $this->mimeTypes)]];
255
                }
256
257 17
                return null;
258 5
            case UPLOAD_ERR_INI_SIZE:
259 5
            case UPLOAD_ERR_FORM_SIZE:
260 1
                return [$this->tooBig, [
261 1
                    'file' => $value->getClientFilename(),
262 1
                    'limit' => $this->getSizeLimit(),
263 1
                    'formattedLimit' => Yii::$app->formatter->asShortSize($this->getSizeLimit()),
264
                ]];
265 5
            case UPLOAD_ERR_PARTIAL:
266 2
                Yii::warning('File was only partially uploaded: ' . $value->getClientFilename(), __METHOD__);
267 2
                break;
268 3
            case UPLOAD_ERR_NO_TMP_DIR:
269 1
                Yii::warning('Missing the temporary folder to store the uploaded file: ' . $value->getClientFilename(), __METHOD__);
270 1
                break;
271 2
            case UPLOAD_ERR_CANT_WRITE:
272 1
                Yii::warning('Failed to write the uploaded file to disk: ' . $value->getClientFilename(), __METHOD__);
273 1
                break;
274 1
            case UPLOAD_ERR_EXTENSION:
275 1
                Yii::warning('File upload was stopped by some PHP extension: ' . $value->getClientFilename(), __METHOD__);
276 1
                break;
277
            default:
278
                break;
279
        }
280
281 5
        return [$this->message, []];
282
    }
283
284
    /**
285
     * Returns the maximum size allowed for uploaded files.
286
     *
287
     * This is determined based on four factors:
288
     *
289
     * - 'upload_max_filesize' in php.ini
290
     * - 'post_max_size' in php.ini
291
     * - 'MAX_FILE_SIZE' hidden field
292
     * - [[maxSize]]
293
     *
294
     * @return int the size limit for uploaded files.
295
     */
296 2
    public function getSizeLimit()
297
    {
298
        // Get the lowest between post_max_size and upload_max_filesize, log a warning if the first is < than the latter
299 2
        $limit = $this->sizeToBytes(ini_get('upload_max_filesize'));
300 2
        $postLimit = $this->sizeToBytes(ini_get('post_max_size'));
301 2
        if ($postLimit > 0 && $postLimit < $limit) {
302
            Yii::warning('PHP.ini\'s \'post_max_size\' is less than \'upload_max_filesize\'.', __METHOD__);
303
            $limit = $postLimit;
304
        }
305 2
        if ($this->maxSize !== null && $limit > 0 && $this->maxSize < $limit) {
306 2
            $limit = $this->maxSize;
307
        }
308
309 2
        if (($request = Yii::$app->getRequest()) instanceof \yii\web\Request) {
310 1
            $maxFileSize = Yii::$app->getRequest()->getBodyParam('MAX_FILE_SIZE', 0);
311 1
            if ($maxFileSize > 0 && $maxFileSize < $limit) {
312 1
                $limit = (int)$maxFileSize;
313
            }
314
        }
315
316 2
        return $limit;
317
    }
318
319
    /**
320
     * @inheritdoc
321
     * @param bool $trim
322
     */
323 1
    public function isEmpty($value, $trim = false)
0 ignored issues
show
Unused Code introduced by
The parameter $trim is not used and could be removed.

This check looks from parameters that have been defined for a function or method, but which are not used in the method body.

Loading history...
324
    {
325 1
        $value = is_array($value) ? reset($value) : $value;
326 1
        return !($value instanceof UploadedFile) || $value->error == UPLOAD_ERR_NO_FILE;
327
    }
328
329
    /**
330
     * Converts php.ini style size to bytes.
331
     *
332
     * @param string $sizeStr $sizeStr
333
     * @return int
334
     */
335 2
    private function sizeToBytes($sizeStr)
336
    {
337 2
        switch (substr($sizeStr, -1)) {
338 2
            case 'M':
339
            case 'm':
340 2
                return (int) $sizeStr * 1048576;
341
            case 'K':
342
            case 'k':
343
                return (int) $sizeStr * 1024;
344
            case 'G':
345
            case 'g':
346
                return (int) $sizeStr * 1073741824;
347
            default:
348
                return (int) $sizeStr;
349
        }
350
    }
351
352
    /**
353
     * Checks if given uploaded file have correct type (extension) according current validator settings.
354
     * @param UploadedFile $file
355
     * @return bool
356
     */
357 14
    protected function validateExtension($file)
358
    {
359 14
        $extension = mb_strtolower($file->extension, 'UTF-8');
360
361 14
        if ($this->checkExtensionByMimeType) {
362 12
            $mimeType = FileHelper::getMimeType($file->tempFilename, null, false);
363 12
            if ($mimeType === null) {
364
                return false;
365
            }
366
367 12
            $extensionsByMimeType = FileHelper::getExtensionsByMimeType($mimeType);
368
369 12
            if (!in_array($extension, $extensionsByMimeType, true)) {
370
                return false;
371
            }
372
        }
373
374 14
        if (!in_array($extension, $this->extensions, true)) {
375 7
            return false;
376
        }
377
378 9
        return true;
379
    }
380
381
    /**
382
     * @inheritdoc
383
     */
384
    public function clientValidateAttribute($model, $attribute, $view)
385
    {
386
        ValidationAsset::register($view);
387
        $options = $this->getClientOptions($model, $attribute);
388
        return 'yii.validation.file(attribute, messages, ' . Json::encode($options) . ');';
389
    }
390
391
    /**
392
     * @inheritdoc
393
     */
394
    public function getClientOptions($model, $attribute)
395
    {
396
        $label = $model->getAttributeLabel($attribute);
397
398
        $options = [];
399
        if ($this->message !== null) {
400
            $options['message'] = $this->formatMessage($this->message, [
401
                'attribute' => $label,
402
            ]);
403
        }
404
405
        $options['skipOnEmpty'] = $this->skipOnEmpty;
406
407
        if (!$this->skipOnEmpty) {
408
            $options['uploadRequired'] = $this->formatMessage($this->uploadRequired, [
409
                'attribute' => $label,
410
            ]);
411
        }
412
413
        if ($this->mimeTypes !== null) {
414
            $mimeTypes = [];
415
            foreach ($this->mimeTypes as $mimeType) {
0 ignored issues
show
Bug introduced by
The expression $this->mimeTypes of type array|string is not guaranteed to be traversable. How about adding an additional type check?

There are different options of fixing this problem.

  1. If you want to be on the safe side, you can add an additional type-check:

    $collection = json_decode($data, true);
    if ( ! is_array($collection)) {
        throw new \RuntimeException('$collection must be an array.');
    }
    
    foreach ($collection as $item) { /** ... */ }
    
  2. If you are sure that the expression is traversable, you might want to add a doc comment cast to improve IDE auto-completion and static analysis:

    /** @var array $collection */
    $collection = json_decode($data, true);
    
    foreach ($collection as $item) { /** .. */ }
    
  3. Mark the issue as a false-positive: Just hover the remove button, in the top-right corner of this issue for more options.

Loading history...
416
                $mimeTypes[] = new JsExpression(Html::escapeJsRegularExpression($this->buildMimeTypeRegexp($mimeType)));
417
            }
418
            $options['mimeTypes'] = $mimeTypes;
419
            $options['wrongMimeType'] = $this->formatMessage($this->wrongMimeType, [
420
                'attribute' => $label,
421
                'mimeTypes' => implode(', ', $this->mimeTypes),
422
            ]);
423
        }
424
425
        if ($this->extensions !== null) {
426
            $options['extensions'] = $this->extensions;
427
            $options['wrongExtension'] = $this->formatMessage($this->wrongExtension, [
428
                'attribute' => $label,
429
                'extensions' => implode(', ', $this->extensions),
430
            ]);
431
        }
432
433
        if ($this->minSize !== null) {
434
            $options['minSize'] = $this->minSize;
435
            $options['tooSmall'] = $this->formatMessage($this->tooSmall, [
436
                'attribute' => $label,
437
                'limit' => $this->minSize,
438
                'formattedLimit' => Yii::$app->formatter->asShortSize($this->minSize),
439
            ]);
440
        }
441
442
        if ($this->maxSize !== null) {
443
            $options['maxSize'] = $this->maxSize;
444
            $options['tooBig'] = $this->formatMessage($this->tooBig, [
445
                'attribute' => $label,
446
                'limit' => $this->getSizeLimit(),
447
                'formattedLimit' => Yii::$app->formatter->asShortSize($this->getSizeLimit()),
448
            ]);
449
        }
450
451
        if ($this->maxFiles !== null) {
452
            $options['maxFiles'] = $this->maxFiles;
453
            $options['tooMany'] = $this->formatMessage($this->tooMany, [
454
                'attribute' => $label,
455
                'limit' => $this->maxFiles,
456
            ]);
457
        }
458
459
        return $options;
460
    }
461
462
    /**
463
     * Builds the RegExp from the $mask.
464
     *
465
     * @param string $mask
466
     * @return string the regular expression
467
     * @see mimeTypes
468
     */
469 11
    private function buildMimeTypeRegexp($mask)
470
    {
471 11
        return '/^' . str_replace('\*', '.*', preg_quote($mask, '/')) . '$/';
472
    }
473
474
    /**
475
     * Checks the mimeType of the $file against the list in the [[mimeTypes]] property.
476
     *
477
     * @param UploadedFile $file
478
     * @return bool whether the $file mimeType is allowed
479
     * @throws \yii\base\InvalidConfigException
480
     * @see mimeTypes
481
     * @since 2.0.8
482
     */
483 12
    protected function validateMimeType($file)
484
    {
485 12
        $fileMimeType = FileHelper::getMimeType($file->tempFilename);
486
487 12
        foreach ($this->mimeTypes as $mimeType) {
0 ignored issues
show
Bug introduced by
The expression $this->mimeTypes of type array|string is not guaranteed to be traversable. How about adding an additional type check?

There are different options of fixing this problem.

  1. If you want to be on the safe side, you can add an additional type-check:

    $collection = json_decode($data, true);
    if ( ! is_array($collection)) {
        throw new \RuntimeException('$collection must be an array.');
    }
    
    foreach ($collection as $item) { /** ... */ }
    
  2. If you are sure that the expression is traversable, you might want to add a doc comment cast to improve IDE auto-completion and static analysis:

    /** @var array $collection */
    $collection = json_decode($data, true);
    
    foreach ($collection as $item) { /** .. */ }
    
  3. Mark the issue as a false-positive: Just hover the remove button, in the top-right corner of this issue for more options.

Loading history...
488 12
            if ($mimeType === $fileMimeType) {
489
                return true;
490
            }
491
492 12
            if (strpos($mimeType, '*') !== false && preg_match($this->buildMimeTypeRegexp($mimeType), $fileMimeType)) {
493 12
                return true;
494
            }
495
        }
496
497 5
        return false;
498
    }
499
}
500