文件上传

在Yii里上传文件通常使用yii\web\UploadedFile类，它把每个上传的文件封装成UploadedFile对象。结合yii\widgets\ActiveForm和models，你可以轻松实现安全的上传文件机制。

创建模型

和普通的文本输入框类似，当要上传一个文件时，你需要创建一个模型类并且用其中的某个属性来接收上传的文件实例。你还需要声明一条验证规则以验证上传的文件。举例来讲，

namespaceapp\models;useyii\base\Model;useyii\web\UploadedFile;classUploadFormextendsModel{public$imageFile;publicfunctionrules(){return[ [['imageFile'],'file','skipOnEmpty'=>false,'extensions'=>'png, jpg'], ]; }publicfunctionupload(){if($this->validate()) {$this->imageFile->saveAs('uploads/'.$this->imageFile->baseName .'.'.$this->imageFile->extension);returntrue; }else{returnfalse; } } }

在以上代码里，imageFile属性用于接收上传的文件实例。它对应一条file验证规则，该规则使用 yii\validators\FileValidator 来确保只上传扩展名为png或jpg的文件。upload()方法会执行该验证并且把上传的文件保存在服务器上。

通过file验证器，你可以检查文件的扩展名，大小，MIME类型等等。详情请查阅 Core Validatators 章节。

>提示: 如果你要上传的是一张图片，可以考虑使用image验证器。image验证器是通过yii\validators\ImageValidator实现验证的，确保对应的模型属性收到的文件是有效的图片文件，然后才保存，或者使用扩展类Imagine Extension进行处理.

渲染文件输入

接下来，在视图里创建一个文件输入控件

useyii\widgets\ActiveForm;?>$form= ActiveForm::begin(['options'=> ['enctype'=>'multipart/form-data']])?>=$form->field($model,'imageFile')->fileInput()?>ActiveForm::end()?>

需要注意的是要记得在表单选项里加入enctype属性以确保文件能被正常上传。fileInput()方法会渲染一个标签，让用户可以选择一个文件上传。

视图和模型的连接

现在，在控制器方法里编写连接模型和视图的代码以实现文件上传。

namespaceapp\controllers;useYii;useyii\web\Controller;useapp\models\UploadForm;useyii\web\UploadedFile;classSiteControllerextendsController{publicfunctionactionUpload(){$model=newUploadForm();if(Yii::$app->request->isPost) {$model->imageFile = UploadedFile::getInstance($model,'imageFile');if($model->upload()) {// 文件上传成功return; } }return$this->render('upload', ['model'=>$model]); } }

在上面的代码里，当提交表单的时候，yii\web\UploadedFile::getInstance()方法就被调用，上传的文件用一个UploadedFile实例表示。然后，我们依靠模型的验证规则确保上传的文件是有效的，并将文件保存在服务器上。

上传多个文件

将前面所述的代码做一些调整，也可以一次性上传多个文件。

首先你得调整模型类，在file验证规则里增加一个maxFiles选项，用以限制一次上传文件的最大数量。upload()方法也得修改, 以便一个一个地保存上传的文件。

namespaceapp\models;useyii\base\Model;useyii\web\UploadedFile;classUploadFormextendsModel{public$imageFiles;publicfunctionrules(){return[ [['imageFiles'],'file','skipOnEmpty'=>false,'extensions'=>'png, jpg','maxFiles'=>4], ]; }publicfunctionupload(){if($this->validate()) {foreach($this->imageFilesas$file) {$file->saveAs('uploads/'.$file->baseName .'.'.$file->extension); }returntrue; }else{returnfalse; } } }

在视图文件里，你需要把multiple选项添加到fileInput()函数调用里，这样文件输入控件就可以接收多个文件。

useyii\widgets\ActiveForm;?>$form= ActiveForm::begin(['options'=> ['enctype'=>'multipart/form-data']])?>=$form->field($model,'imageFiles[]')->fileInput(['multiple'=>true,'accept'=>'image
public$filename;


public$key;


protected$fileObject;// SplFileObject is very convenient for seeking to particular line in a file



publicfunctioninit()
{
parent::init();

// open file
$this->fileObject =newSplFileObject($this->filename);
}


protectedfunctionprepareModels()
{
$models= [];
$pagination=$this->getPagination();

if($pagination===false) {
// in case there's no pagination, read all lines
while(!$this->fileObject->eof()) {
$models[] =$this->fileObject->fgetcsv();
$this->fileObject->next();
}
}else{
// in case there's pagination, read only a single page
$pagination->totalCount =$this->getTotalCount();
$this->fileObject->seek($pagination->getOffset());
$limit=$pagination->getLimit();

for($count=0;$count<$limit; ++$count) {
$models[] =$this->fileObject->fgetcsv();
$this->fileObject->next();
}
}

return$models;
}


protectedfunctionprepareKeys($models)
{
if($this->key !==null) {
$keys= [];

foreach($modelsas$model) {
if(is_string($this->key)) {
$keys[] =$model[$this->key];
}else{
$keys[] = call_user_func($this->key,$model);
}
}

return$keys;
}else{
returnarray_keys($models);
}
}


protectedfunctionprepareTotalCount()
{
$count=0;

while(!$this->fileObject->eof()) {
$this->fileObject->next();
++$count;
}

return$count;
}
}

Previous article： Next article：