脦脛錄鎂脡脧麓蘆 · tp5文檔

# 文件上傳本篇主要介紹如何使用`ThinkPHP5`進行文件上傳及驗證。 - - [控制器定義](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/179236#u63A7u5236u5668u5B9Au4E49) - [上傳文件驗證](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/179236#u4E0Au4F20u6587u4EF6u9A8Cu8BC1) - [文件保存規則](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/179236#u6587u4EF6u4FDDu5B58u89C4u5219) - [多文件上傳](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/179236#u591Au6587u4EF6u4E0Au4F20) - [后續文件操作](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/179236#u540Eu7EEDu6587u4EF6u64CDu4F5C) ## 控制器定義 > 文件上傳使用ThinkPHP5內置的`think\File`類庫，該類庫可以輕松實現文件上傳到本地服務器，如果需要上傳到其它服務器或者平臺，則需要后續調用其它類庫或者接口。首先來創建一個Upload控制器如下： ``` <pre class="calibre18"> ``` <?phpnamespace app\index\controller; use think\Request; class Upload extends \think\Controller{ // 文件上傳表單public function index(){ return $this->fetch(); } // 文件上傳提交public function up(Request $request){ // 獲取表單上傳文件$file = $request->file('file'); if (empty($file)) { $this->error('請選擇上傳文件'); } // 移動到框架應用根目錄/public/uploads/ 目錄下$info = $file->move(ROOT_PATH . 'public' . DS . 'uploads'); if ($info) { $this->success('文件上傳成功：' . $info->getRealPath()); } else { // 上傳失敗獲取錯誤信息$this->error($file->getError()); } } } ``` ``` 然后創建模板文件（`application/index/view/upload/index.html`）: ``` <pre class="calibre18"> ``` <!doctype html><html><head><meta charset="UTF-8"><title>文件上傳示例</title><style>body { font-family:"Microsoft Yahei","Helvetica Neue",Helvetica,Arial,sans-serif; font-size:16px; padding:5px; }.form{ padding: 15px; font-size: 16px; }.form .text { padding: 3px; margin:2px 10px; width: 240px; height: 24px; line-height: 28px; border: 1px solid #D4D4D4; }.form .btn{ margin:6px; padding: 6px; width: 120px; font-size: 16px; border: 1px solid #D4D4D4; cursor: pointer; background:#eee; }.form .file{ margin:6px; padding: 6px; width: 220px; font-size: 16px; border: 1px solid #D4D4D4; cursor: pointer; background:#eee; }a{ color: #868686; cursor: pointer; }a:hover{ text-decoration: underline; } h2{ color: #4288ce; font-weight: 400; padding: 6px 0; margin: 6px 0 0; font-size: 28px; border-bottom: 1px solid #eee; }div{ margin:8px; }.info{ padding: 12px 0; border-bottom: 1px solid #eee; }.copyright{ margin-top: 24px; padding: 12px 0; border-top: 1px solid #eee; }</style></head><body><h2>文件上傳示例</h2><FORM method="post" enctype="multipart/form-data" class="form" action="{:url('up')}"> 選擇文件：<INPUT type="file" class="file" name="file"><br/><INPUT type="submit" class="btn" value=" 提交 "></FORM><div class="copyright"><a title="官方網站" href="http://www.thinkphp.cn">ThinkPHP</a><span>V5</span><span>{ 十年磨一劍-為API開發設計的高性能框架 }</span></div></body></html> ``` ``` 訪問下面的URL地址： ``` <pre class="calibre18"> ``` http: //tp5.com/index/upload ``` ``` ![](https://img.kancloud.cn/ce/31/ce3161d1487d32532cff6af5505f3e1e_766x368.png) 如果沒有選擇任何文件點擊提交的話，會顯示： ![](https://img.kancloud.cn/23/fc/23fcea7b9f7a8b6fa836daebd8d36fc8_652x344.png) 選擇文件后點擊提交： ![](https://img.kancloud.cn/ed/82/ed82d381fdac150a1ca1710849d9777c_755x368.png) ![](https://img.kancloud.cn/0c/5d/0c5d787b74b375a9ee5e4a2d55e9e247_2110x443.png) 默認的上傳文件會按照當前的日期自動保存 ## 上傳文件驗證可以在上傳之前調用`validate`方法設置驗證規則，例如： ``` <pre class="calibre18"> ``` // 文件上傳提交public function up(Request $request){ // 獲取表單上傳文件$file = $request->file('file'); if (empty($file)) { $this->error('請選擇上傳文件'); } // 移動到框架應用根目錄/public/uploads/ 目錄下$info = $file->validate(['ext' => 'jpg,png'])->move(ROOT_PATH . 'public' . DS . 'uploads'); if ($info) { $this->success('文件上傳成功：' . $info->getRealPath()); } else { // 上傳失敗獲取錯誤信息$this->error($file->getError()); } } ``` ``` `validate`方法設置了允許上傳的文件后綴是jpg和png，當我們選擇一個gif格式的文件后，會提示： ![](https://img.kancloud.cn/71/fd/71fdbee2d76ecc099f509da23f5cb479_664x346.png) `validate`方法支持的驗證規則包括：驗證規則說明參數類型 size 上傳文件最大字節大小 integer ext 允許上傳的文件后綴數組或者字符串 type 允許上傳的文件類型數組或者字符串如果上傳的文件后綴是圖像格式的話，系統會自動檢測是否為合法的圖像文件，例如，我們創建一個hello.jpg文件，并且寫入下列文本內容 ``` <pre class="calibre18"> ``` Hello，ThinkPHP5！ ``` ``` 當我們上傳該文件并且提交后顯示： ![](https://img.kancloud.cn/e4/2c/e42c1280e5428ae518a6a487133632b7_687x336.png) > 注意：文件上傳驗證用到了`exif`擴展，如果沒有開啟請自行開啟。如果你統一使用驗證類`think\Validate`對表單進行驗證，也可以直接使用控制器類`think\Controller`的`validate`方法進行上傳文件驗證，修改控制器up方法的代碼為： ``` <pre class="calibre18"> ``` // 文件上傳提交public function up(Request $request){ // 獲取表單上傳文件$file = $request->file('file'); // 上傳文件驗證$result = $this->validate(['file' => $file], ['file'=>'require|image'],['file.require' => '請選擇上傳文件', 'file.image' => '非法圖像文件']); if(true !== $result){ $this->error($result); } // 移動到框架應用根目錄/public/uploads/ 目錄下$info = $file->move(ROOT_PATH . 'public' . DS . 'uploads'); if ($info) { $this->success('文件上傳成功：' . $info->getRealPath()); } else { // 上傳失敗獲取錯誤信息$this->error($file->getError()); } } ``` ``` 關鍵的代碼是這行： ``` <pre class="calibre18"> ``` // 上傳文件驗證$result = $this->validate(['file' => $file], ['file'=>'require|image'],['file.require' => '請選擇上傳文件', 'file.image' => '非法圖像文件']); ``` ``` 由于設置了`require`驗證規則（表示必須上傳文件），所以如果沒有選擇任何文件直接提交的話，頁面會提示： ![](https://img.kancloud.cn/23/fc/23fcea7b9f7a8b6fa836daebd8d36fc8_652x344.png) `image`驗證規則表示上傳的必須是一個圖像文件，如果選擇上傳了一個文本文件，頁面會提示： ![](https://img.kancloud.cn/e4/2c/e42c1280e5428ae518a6a487133632b7_687x336.png) 如果需要上傳一個100\*100的`PNG`圖像文件，可以這樣進行驗證： ``` <pre class="calibre18"> ``` // 上傳文件驗證$result = $this->validate(['file' => $file], ['file'=>'require|image:100,100,png'],['file.require' => '請選擇上傳文件', 'file.image' => '必須是100*100的PNG格式文件']); ``` ``` 更多的上傳文件驗證規則還包括：驗證規則說明 file 驗證是否為File對象 image 驗證是否為圖像File對象 image:width,height\[,type\] 驗證圖像文件的類型和寬高 fileExt:zip,doc,... 驗證文件后綴 fileMime:image/png,... 驗證文件類型 fileSize:1024 驗證文件大小## 文件保存規則可以在上傳之前調用`rule`方法設置上傳文件的保存規則。 ``` <pre class="calibre18"> ``` // 文件上傳提交public function up(Request $request){ // 獲取表單上傳文件$file = $request->file('file'); if (empty($file)) { $this->error('請選擇上傳文件'); } // 移動到框架應用根目錄/public/uploads/ 目錄下$info = $file->rule('md5')->move(ROOT_PATH . 'public' . DS . 'uploads'); if ($info) { $this->success('文件上傳成功：' . $info->getRealPath()); } else { // 上傳失敗獲取錯誤信息$this->error($file->getError()); } } ``` ``` ![](https://img.kancloud.cn/d7/73/d773392e52c76e74a8f84c496c9bf00b_1878x449.png) 系統默認提供了幾種上傳命名規則，包括：規則描述 date 根據日期和微秒數生成（默認規則） md5 對文件使用md5\_file散列生成 sha1 對文件使用sha1\_file散列生成> 其中md5和sha1規則會自動以散列值的前兩個字符作為子目錄，后面的散列值作為文件名。如果需要自定義上傳文件的保存規則，可以使用： ``` <pre class="calibre18"> ``` // 移動到框架應用根目錄/public/uploads/ 目錄下 $info = $file->rule('uniqid')->move(ROOT_PATH . 'public' . DS . 'uploads'); ``` ``` 這里使用了`uniqid`函數來生成唯一的ID命名上傳文件，如果必要，還可以支持使用閉包定義規則，例如： ``` <pre class="calibre18"> ``` // 移動到框架應用根目錄/public/uploads/ 目錄下$info = $file->rule(function ($file) { // 使用自定義的文件保存規則return $file->getInfo('type') . uniqid(); })->move(ROOT_PATH . 'public' . DS . 'uploads'); ``` ``` ![](https://img.kancloud.cn/2c/03/2c0365dfb97675352192f3bd8c583e54_1966x346.png) 如果希望指定某個文件的保存文件名，還可以直接使用： ``` <pre class="calibre18"> ``` // 移動到框架應用根目錄/public/uploads/ 目錄下 $info = $file->move(ROOT_PATH . 'public' . DS . 'uploads','test'); ``` ``` ![](https://img.kancloud.cn/79/da/79daee05a518766867466711b9c4f5e9_1369x353.png) 如果希望保持上傳文件的原文件名保存，則可以使用 ``` <pre class="calibre18"> ``` // 移動到框架應用根目錄/public/uploads/ 目錄下 $info = $file->move(ROOT_PATH . 'public' . DS . 'uploads',''); ``` ``` 默認情況下，會覆蓋服務器上傳目錄下的同名文件，如果不希望覆蓋，可以使用： ``` <pre class="calibre18"> ``` // 移動到服務器的上傳目錄并且設置不覆蓋$file->move(ROOT_PATH . 'public' . DS . 'uploads',true,false); ``` ``` 如果要獲取上傳的保存文件名，可以調用返回對象的`getSaveName`方法： ``` <pre class="calibre18"> ``` $info = $file->rule('md5')->move(ROOT_PATH . 'public' . DS . 'uploads'); if ($info) { echo $info->getSaveName(); } else { $this->error($file->getError()); } ``` ``` ## 多文件上傳如果你使用的是多文件上傳表單，例如： ``` <pre class="calibre18"> ``` <FORM method="post" enctype="multipart/form-data" class="form" action="{:url('up')}"> <input type="file" name="image[]" /> <input type="file" name="image[]" /> <input type="file" name="image[]" /> <INPUT type="submit" class="btn" value=" 提交 "> </FORM> ``` ``` 控制器代碼可以改成： ``` <pre class="calibre18"> ``` public function up(Request $request){ // 獲取表單上傳文件$files = $request->file('image'); $item = []; foreach($files as $file){ // 移動到框架應用根目錄/public/uploads/ 目錄下$info = $file->move(ROOT_PATH . 'public' . DS . 'uploads'); if($info){ $item[] = $info->getRealPath(); }else{ // 上傳失敗獲取錯誤信息$this->error($file->getError()); } } $this->success('文件上傳成功'.implode(' ',$item)); } ``` ``` ## 后續文件操作上傳成功后返回的是`File`對象，除了可以使用`SplFileObject`的屬性和方法之外，還可以使用File類自身提供的下列方法，便于進行后續的文件處理（例如對圖像文件進行剪裁處理或者移動到遠程服務器）。方法描述 getSaveName 獲取保存的文件名（包含動態生成的目錄） getInfo 獲取上傳文件信息 getMime 獲取文件的MIME信息 md5 獲取文件的md5散列值 sha1 獲取文件的sha1散列值下面是一個簡單的FTP文件移動的處理例子。 ``` <pre class="calibre18"> ``` public function up(Request $request){ // 獲取表單上傳文件$file = $request->file('file'); // 上傳文件$info = $file->move(ROOT_PATH . 'public' . DS . 'uploads'); if ($info) { // 移動文件到FTP服務器$link = ftp_connect('212.45.5.78'); ftp_login($link, 'root', 'password'); /* 移動文件 */$path = ftp_pwd($link) . '/uploads/'; if (!ftp_put($link, $path.$info->getFilename(), $info->getRealPath(), FTP_BINARY)) { $this->error('文件上傳保存錯誤！'); } } else { // 上傳失敗獲取錯誤信息$this->error($file->getError()); } } ``` ``` 還可以對上傳的文件進行處理，后面我們還會講到對上傳圖像文件進行額外的圖像處理。