Загрузка файлов

Загрузка файлов в Yii обычно выполняется с помощью yii\web\UploadedFile, который инкапсулирует каждый загруженный файл как объект UploadedFile. В сочетании с yii\widgets\ActiveForm и моделями вы можете легко реализовать механизм безопасной загрузки файлов.

Создание моделей

Подобно работе с текстовыми вводами, чтобы загрузить один файл, вы должны создать модельный класс и использовать атрибут модели для хранения загружаемого экземпляра файла. Вы также должны объявить правило проверки для проверки загрузки файла. Например:

namespace app\models;

use yii\base\Model;
use yii\web\UploadedFile;

class UploadForm extends Model
{
    /**
     * @var UploadedFile
     */
    public $imageFile;

    public function rules()
    {
        return [
            [['imageFile'], 'file', 'skipOnEmpty' => false, 'extensions' => 'png, jpg'],
        ];
    }
    
    public function upload()
    {
        if ($this->validate()) {
            $this->imageFile->saveAs('uploads/' . $this->imageFile->baseName . '.' . $this->imageFile->extension);
            return true;
        } else {
            return false;
        }
    }
}

В приведенном выше коде атрибут imageFile используется для хранения загруженного экземпляра файла. Это связано с правилом проверки file, которое использует yii\validators\FileValidator для обеспечения загрузки имени файла с расширением png или jpg. Метод upload () выполнит проверку и сохранит загруженный файл на сервере.

Средство проверки файлов позволяет проверять расширения файлов, размер, тип MIME и т. д. 

Ввод файла в файл

Затем создайте файл для представления в представлении:

<?php
use yii\widgets\ActiveForm;
?>

<?php $form = ActiveForm::begin(['options' => ['enctype' => 'multipart/form-data']]) ?>

    <?= $form->field($model, 'imageFile')->fileInput() ?>

    <button>Submit</button>

<?php ActiveForm::end() ?>

Важно помнить, что вы добавляете к форме форму enctype, чтобы файл мог быть правильно загружен. Вызов fileInput() выдаст тег <input type = "file">, который позволит пользователям выбирать файл для загрузки.

Подключение

Теперь в действии контроллера напишите код для подключения модели и представления для реализации загрузки файлов:

namespace app\controllers;

use Yii;
use yii\web\Controller;
use app\models\UploadForm;
use yii\web\UploadedFile;

class SiteController extends Controller
{
    public function actionUpload()
    {
        $model = new UploadForm();

        if (Yii::$app->request->isPost) {
            $model->imageFile = UploadedFile::getInstance($model, 'imageFile');
            if ($model->upload()) {
                // file is uploaded successfully
                return;
            }
        }

        return $this->render('upload', ['model' => $model]);
    }
}

В приведенном выше коде, когда форма отправлена, вызывается метод yii\web\UploadedFile::getInstance(), чтобы представлять загруженный файл как экземпляр UploadedFile. Затем мы полагаемся на валидацию модели, чтобы убедиться, что загруженный файл действителен и сохранить файл на сервере.

Загрузка нескольких файлов

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

Сначала вы должны настроить класс модели, добавив параметр maxFiles в правиле проверки file, чтобы ограничить максимальное количество файлов, разрешенных для загрузки. Установка maxFiles в 0 означает, что нет ограничений на количество файлов, которые могут быть загружены одновременно. Максимальное количество файлов, разрешенных к загрузке одновременно, также ограничено директивой PHP max_file_uploads, которая по умолчанию равна 20. Метод upload() также должен быть обновлен для сохранения загруженных файлов по одному.

namespace app\models;

use yii\base\Model;
use yii\web\UploadedFile;

class UploadForm extends Model
{
    /**
     * @var UploadedFile[]
     */
    public $imageFiles;

    public function rules()
    {
        return [
            [['imageFiles'], 'file', 'skipOnEmpty' => false, 'extensions' => 'png, jpg', 'maxFiles' => 4],
        ];
    }
    
    public function upload()
    {
        if ($this->validate()) { 
            foreach ($this->imageFiles as $file) {
                $file->saveAs('uploads/' . $file->baseName . '.' . $file->extension);
            }
            return true;
        } else {
            return false;
        }
    }
}

В файле представления вы должны добавить параметр multiple к вызову fileInput(), чтобы поле для загрузки файла могло получать несколько файлов:

<?php
use yii\widgets\ActiveForm;
?>

<?php $form = ActiveForm::begin(['options' => ['enctype' => 'multipart/form-data']]) ?>

    <?= $form->field($model, 'imageFiles[]')->fileInput(['multiple' => true, 'accept' => 'image/*']) ?>

    <button>Submit</button>

<?php ActiveForm::end() ?>

И, наконец, в действии контроллера вы должны вызвать UploadedFile::getInstances() вместо UploadedFile::getInstance(), чтобы назначить массив экземпляров UploadedFile для UploadForm::imageFiles.

namespace app\controllers;

use Yii;
use yii\web\Controller;
use app\models\UploadForm;
use yii\web\UploadedFile;

class SiteController extends Controller
{
    public function actionUpload()
    {
        $model = new UploadForm();

        if (Yii::$app->request->isPost) {
            $model->imageFiles = UploadedFile::getInstances($model, 'imageFiles');
            if ($model->upload()) {
                // file is uploaded successfully
                return;
            }
        }

        return $this->render('upload', ['model' => $model]);
    }
}