file-upload - yii2 で ActiveRecord を継承したモデルでファイルをアップロードすることはできますか?

Question

yii2 のデータベース テーブルから Gii でモデルを生成しました。このモデルは ActiveRecord を継承しています。次に、このモデルからフォームを作成しました。このフォームでファイルをアップロードしたいと思います。同じモデル(ActiveRecordから継承)でファイルをアップロードすることは可能ですか?

はいの場合、どのように？いいえの場合、どうすればよいですか?

Answer 1

はい、可能ですが、別のフォームを使用することをお勧めします。ファイルのアップロードの記事の公式ドキュメントで詳しく説明されています

別のフォームを作成:

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

レンダリング ファイル入力:

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

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

    <button>Submit</button>

<?php ActiveForm::end() ?>

ファイルのアップロードを処理するようにコントローラーをカスタマイズします。

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

複数のファイルのアップロードについても、この記事で取り上げます。

この関連する質問も参照してください。

filepath を model 属性として保存して使用したい場合は、フォームのメソッドにActiveRecordモデルの作成と保存を追加することができます。upload()フォームを操作するもう 1 つの良い例は、Advanced TemplateのSignupFormです。

<?php

namespace frontend\models;
use yii\base\Model;
use common\models\User;

/**
 * Signup form
 */
class SignupForm extends Model
{
    public $username;
    public $email;
    public $password;


    /**
     * @inheritdoc
     */
    public function rules()
    {
        return [
            ['username', 'trim'],
            ['username', 'required'],
            ['username', 'unique', 'targetClass' => '\common\models\User', 'message' => 'This username has already been taken.'],
            ['username', 'string', 'min' => 2, 'max' => 255],
            ['email', 'trim'],
            ['email', 'required'],
            ['email', 'email'],
            ['email', 'string', 'max' => 255],
            ['email', 'unique', 'targetClass' => '\common\models\User', 'message' => 'This email address has already been taken.'],
            ['password', 'required'],
            ['password', 'string', 'min' => 6],
        ];
    }

    /**
     * Signs user up.
     *
     * @return User|null the saved model or null if saving fails
     */
    public function signup()
    {
        if (!$this->validate()) {
            return null;
        }

        $user = new User();
        $user->username = $this->username;
        $user->email = $this->email;
        $user->setPassword($this->password);
        $user->generateAuthKey();

        return $user->save() ? $user : null;
    }
}

ご覧のとおり、モデルの検証と作成は別の形式に分離されています。これは、モデルで直接処理するよりも優れた方法です (特にファイルのアップロード)。しかし、単純な目的であれば、モデルのみを使用することも許容できます。