# 文件上傳
在Yii里上傳文件通常使用yii\web\UploadedFile類， 它把每個上傳的文件封裝成?`UploadedFile`?對象。 結合yii\widgets\ActiveForm和[models](http://www.yiichina.com/doc/guide/2.0/structure-models)，你可以輕松實現安全的上傳文件機制。
## 創建模型
和普通的文本輸入框類似，當要上傳一個文件時，你需要創建一個模型類并且用其中的某個屬性來接收上傳的文件實例。 你還需要聲明一條驗證規則以驗證上傳的文件。 舉例來講，
~~~
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()`?方法會執行該驗證并且把上傳的文件保存在服務器上。
通過?`file`?驗證器，你可以檢查文件的擴展名，大小，MIME類型等等。詳情請查閱?[Core Validatators](http://www.yiichina.com/doc/guide/2.0/tutorial-core-validators#file)?章節。
>提示: 如果你要上傳的是一張圖片，可以考慮使用`image`驗證器。?`image`?驗證器是通過yii\validators\ImageValidator實現驗證的，確保對應的模型屬性 收到的文件是有效的圖片文件，然后才保存，或者使用擴展類[Imagine Extension](https://github.com/yiisoft/yii2-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">`?標簽，讓用戶可以選擇一個文件上傳。
## 視圖和模型的連接
現在，在控制器方法里編寫連接模型和視圖的代碼以實現文件上傳。
~~~
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()) {
// 文件上傳成功
return;
}
}
return $this->render('upload', ['model' => $model]);
}
}
~~~
在上面的代碼里，當提交表單的時候，yii\web\UploadedFile::getInstance()方法就被調用， 上傳的文件用一個?`UploadedFile`?實例表示。然后，我們依靠模型的驗證規則確保上傳的文件是有效的， 并將文件保存在服務器上。
## 上傳多個文件
將前面所述的代碼做一些調整，也可以一次性上傳多個文件。
首先你得調整模型類，在?`file`?驗證規則里增加一個?`maxFiles`?選項，用以限制一次上傳文件的最大數量。?`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() ?>
~~~
最后，在控制器的 action 方法中，你應該調用?`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()) {
// 文件上傳成功
return;
}
}
return $this->render('upload', ['model' => $model]);
}
}
~~~
- 介紹（Introduction）
- 關于 Yii（About Yii）
- 從 Yii 1.1 升級（Upgrading from Version 1.1）
- 入門（Getting Started）
- 安裝 Yii（Installing Yii）
- 運行應用（Running Applications）
- 第一次問候（Saying Hello）
- 使用 Forms（Working with Forms）
- 玩轉 Databases（Working with Databases）
- 用 Gii 生成代碼（Generating Code with Gii）
- 更上一層樓（Looking Ahead）
- 應用結構（Application Structure）
- 結構概述（Overview）
- 入口腳本（Entry Scripts）
- 應用（Applications）
- 應用組件（Application Components）
- 控制器（Controllers）
- 模型（Models）
- 視圖（Views）
- 模塊（Modules）
- 過濾器（Filters）
- 小部件（Widgets）
- 前端資源（Assets）
- 擴展（Extensions）
- 請求處理（Handling Requests）
- 運行概述（Overview）
- 引導（Bootstrapping）
- 路由引導與創建 URL（Routing and URL Creation）
- 請求（Requests）
- 響應（Responses）
- Sessions and Cookies
- 錯誤處理（Handling Errors）
- 日志（Logging）
- 關鍵概念（Key Concepts）
- 組件（Components）
- 屬性（Properties）
- 事件（Events）
- 行為（Behaviors）
- 配置（Configurations）
- 別名（Aliases）
- 類自動加載（Class Autoloading）
- 服務定位器（Service Locator）
- 依賴注入容器（Dependency Injection Container）
- 配合數據庫工作（Working with Databases）
- 數據庫訪問（Data Access Objects）: 數據庫連接、基本查詢、事務和模式操作
- 查詢生成器（Query Builder）: 使用簡單抽象層查詢數據庫
- 活動記錄（Active Record）: 活動記錄對象關系映射（ORM），檢索和操作記錄、定義關聯關系
- 數據庫遷移（Migrations）: 在團體開發中對你的數據庫使用版本控制
- Sphinx
- Redis
- MongoDB
- ElasticSearch
- 接收用戶數據（Getting Data from Users）
- 創建表單（Creating Forms）
- 輸入驗證（Validating Input）
- 文件上傳（Uploading Files）
- 收集列表輸入（Collecting Tabular Input）
- 多模型同時輸入（Getting Data for Multiple Models）
- 顯示數據（Displaying Data）
- 格式化輸出數據（Data Formatting）
- 分頁（Pagination）
- 排序（Sorting）
- 數據提供器（Data Providers）
- 數據小部件（Data Widgets）
- 操作客戶端腳本（Working with Client Scripts）
- 主題（Theming）
- 安全（Security）
- 認證（Authentication）
- 授權（Authorization）
- 處理密碼（Working with Passwords）
- 客戶端認證（Auth Clients）
- 安全領域的最佳實踐（Best Practices）
- 緩存（Caching）
- 概述（Overview）
- 數據緩存（Data Caching）
- 片段緩存（Fragment Caching）
- 分頁緩存（Page Caching）
- HTTP 緩存（HTTP Caching）
- RESTful Web 服務
- 快速入門（Quick Start）
- 資源（Resources）
- 控制器（Controllers）
- 路由（Routing）
- 格式化響應（Response Formatting）
- 授權驗證（Authentication）
- 速率限制（Rate Limiting）
- 版本化（Versioning）
- 錯誤處理（Error Handling）
- 開發工具（Development Tools）
- 調試工具欄和調試器（Debug Toolbar and Debugger）
- 使用 Gii 生成代碼（Generating Code using Gii）
- TBD 生成 API 文檔（Generating API Documentation）
- 測試（Testing）
- 概述（Overview）
- 搭建測試環境（Testing environment setup）
- 單元測試（Unit Tests）
- 功能測試（Functional Tests）
- 驗收測試（Acceptance Tests）
- 測試夾具（Fixtures）
- 高級專題（Special Topics）
- 高級應用模版（Advanced Project Template）
- 從頭構建自定義模版（Building Application from Scratch）
- 控制臺命令（Console Commands）
- 核心驗證器（Core Validators）
- 國際化（Internationalization）
- 收發郵件（Mailing）
- 性能優化（Performance Tuning）
- 共享主機環境（Shared Hosting Environment）
- 模板引擎（Template Engines）
- 集成第三方代碼（Working with Third-Party Code）
- 小部件（Widgets）
- Bootstrap 小部件（Bootstrap Widgets）
- jQuery UI 小部件（jQuery UI Widgets）
- 助手類（Helpers）
- 助手一覽（Overview）
- Array 助手（ArrayHelper）
- Html 助手（Html）
- Url 助手（Url）