怎么做

上传文件

上传 Yii 中的文件通常是在[[yii \ web \ UploadedFile]]的帮助下完成的,它将每个上传的文件封装为 UploadedFile 对象。结合[[yii \ widgets \ ActiveForm]]和模型,你可以轻松实现安全的文件上传机制。

创建模型

与使用纯文本输入一样,要上传单个文件,你将创建模型类并使用模型的属性来保留上载的文件实例。你还应声明验证规则以验证文件上载。例如,

namespace app\models;

use yiiase\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 属性用于保存上传的文件实例。它与使用[[yii \ validators \ FileValidator]]的 file 验证规则相关联,以确保上传扩展名为 pngjpg 的文件。upload() 方法将执行验证并将上载的文件保存在服务器上。

file 验证器允许你检查文件扩展名,大小,MIME 类型等。有关更多详细信息,请参阅核心验证器部分。

提示:如果要上传图像,可以考虑使用 image 验证器。image 验证器通过[[yii \ validators \ ImageValidator]]实现,验证属性是否已收到有效图像,然后可以使用 Imagine Extension 保存或处理该图像。

渲染文件输入

接下来,在视图中创建文件输入:

<?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 选项添加到表单。

接线

现在在控制器操作中,编写代码以连接模型和视图以实现文件上载:

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 实例。然后,我们依靠模型验证来确保上载的文件有效并将文件保存在服务器上。

上传多个文件

你还可以一次上传多个文件,并对前面小节中列出的代码进行一些调整。

首先,你应该通过在 file 验证规则中添加 maxFiles 选项来调整模型类,以限制允许上载的最大文件数。将 maxFiles 设置为 0 意味着可以同时上载的文件数量没有限制。允许同时上传的最大文件数也受限于 PHP 指令 max_file_uploads ,默认为 20.还应更新 upload() 方法以逐个保存上传的文件。

namespace app\models;

use yiiase\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() 来为 UploadForm::imageFiles 分配一个 UploadedFile 实例数组。

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