Класс yii\web\MultipartFormDataParser

MultipartFormDataParser парсит содержимое, закодированное как 'multipart/form-data'.

Этот парсер предоставляет резервный вариант для обработки 'multipart/form-data' при запросах, отличных от POST, например: при запросе с методом 'PUT'.

Для включения этого парсера необходимо настроить yii\web\Request::$parsers следующим образом:

return [
    'components' => [
        'request' => [
            'parsers' => [
                'multipart/form-data' => 'yii\web\MultipartFormDataParser'
            ],
        ],
        // ...
    ],
    // ...
];

Метод parse() этого парсера автоматически заполняет $_FILES файлами, извлечёнными из тела запроса.

Примечание: поскольку это парсер запроса, он инициализирует значения $_FILES в yii\web\Request::getBodyParams(). До вызова этого метода массив $_FILES остаётся пустым, даже если в теле запроса есть отправленные файлы. Убедитесь, что вы запросили параметры тела запроса перед любой попыткой получить загруженный файл, если используете этот парсер.

Пример использования:

use yii\web\UploadedFile;

$restRequestData = Yii::$app->request->getBodyParams();
$uploadedFile = UploadedFile::getInstancesByName('photo');

$model = new Item();
$model->populate($restRequestData);
copy($uploadedFile->tempName, '/path/to/file/storage/photo.jpg');

Примечание: хотя этот парсер полностью эмулирует обычную структуру $_FILES, связанные временные файлы, доступные через ключ tmp_name, не будут распознаны PHP как загруженные. Таким образом, функции, такие как is_uploaded_file() и move_uploaded_file(), не сработают с ними. Это также означает, что yii\web\UploadedFile::saveAs() также не сработает.

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

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

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

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

Максимальное количество загружаемых файлов.

public integer getUploadFileMaxCount ( )
public void setUploadFileMaxCount ( $uploadFileMaxCount )

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

Максимальный размер загружаемого файла в байтах.

public integer getUploadFileMaxSize ( )
public void setUploadFileMaxSize ( $uploadFileMaxSize )

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