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

Как это сделать

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

Загрузка файлов в 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 атрибут imageFile используется для хранения экземпляра загруженного файла. Он связан с правилом проверки file который использует [[yii \ validators \ FileValidator]] для обеспечения загрузки файла с расширением png или jpg . Метод upload() выполнит проверку и сохранит загруженный файл на сервере.

file валидатор позволяет проверять расширения файлов, размер, тип MIME и т.д. Пожалуйста , обратитесь к разделу Основные валидаторов для более подробной информации.

Совет. Если вы загружаете изображение, вы можете вместо этого использовать средство проверки image . Валидатор image реализуется с помощью [[yii \ validators \ ImageValidator]], который проверяет, получил ли атрибут допустимое изображение, которое затем может быть сохранено или обработано с помощью расширения Imagine .

Ввод файла изображения

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

<?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"> который позволит пользователям выбирать файл для загрузки.

Совет. Начиная с версии 2.0.8, [[yii \ web \ widgets \ ActiveField :: fileInput | fileInput]] enctype добавляет параметр enctype в форму, когда используется поле ввода файла.

Проводка

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

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]);
    }
}