# 上傳 ## 上傳文件 > 內置的上傳只是上傳到本地服務器，上傳到遠程或者第三方平臺的話需要自己擴展。 假設表單代碼如下： ``` <form action="/index/index/upload" enctype="multipart/form-data" method="post"> <input type="file" name="image" /> <br> <input type="submit" value="上傳" /> </form> ``` 然后在控制器中添加如下的代碼： ``` public function upload(){ // 獲取表單上傳文件 例如上傳了001.jpg $file = request()->file('image'); // 移動到框架應用根目錄/uploads/ 目錄下 $info = $file->move( '../uploads'); if($info){ // 成功上傳后 獲取上傳信息 // 輸出 jpg echo $info->getExtension(); // 輸出 20160820/42a79759f284b767dfcb2a0197904287.jpg echo $info->getSaveName(); // 輸出 42a79759f284b767dfcb2a0197904287.jpg echo $info->getFilename(); }else{ // 上傳失敗獲取錯誤信息 echo $file->getError(); } } ``` `move`方法成功的話返回的是一個`\think\File`對象，你可以對上傳后的文件進行后續操作。 ## 多文件上傳 如果你使用的是多文件上傳表單，例如： ``` <form action="/index/index/upload" enctype="multipart/form-data" method="post"> <input type="file" name="image[]" /> <br> <input type="file" name="image[]" /> <br> <input type="file" name="image[]" /> <br> <input type="submit" value="上傳" /> </form> ``` 控制器代碼可以改成： ``` public function upload(){ // 獲取表單上傳文件 $files = request()->file('image'); foreach($files as $file){ // 移動到框架應用根目錄/uploads/ 目錄下 $info = $file->move( '../uploads'); if($info){ // 成功上傳后 獲取上傳信息 // 輸出 jpg echo $info->getExtension(); // 輸出 42a79759f284b767dfcb2a0197904287.jpg echo $info->getFilename(); }else{ // 上傳失敗獲取錯誤信息 echo $file->getError(); } } } ``` ## 上傳驗證 支持對上傳文件的驗證，包括文件大小、文件類型和后綴： ``` public function upload(){ // 獲取表單上傳文件 例如上傳了001.jpg $file = request()->file('image'); // 移動到框架應用根目錄/uploads/ 目錄下 $info = $file->validate(['size'=>15678,'ext'=>'jpg,png,gif'])->move( '../uploads'); if($info){ // 成功上傳后 獲取上傳信息 // 輸出 jpg echo $info->getExtension(); // 輸出 20160820/42a79759f284b767dfcb2a0197904287.jpg echo $info->getSaveName(); // 輸出 42a79759f284b767dfcb2a0197904287.jpg echo $info->getFilename(); }else{ // 上傳失敗獲取錯誤信息 echo $file->getError(); } } ``` > `getSaveName`方法返回的是圖片的服務器文件地址，并不能直接用于圖片的URL地址，尤其在windows平臺上必須做轉換才能正常顯示圖片。 如果上傳文件驗證不通過，則`move`方法返回false。 驗證參數說明size上傳文件的最大字節ext文件后綴，多個用逗號分割或者數組type文件MIME類型，多個用逗號分割或者數組> 還有一個額外的自動驗證規則是，如果上傳的文件后綴是圖像文件后綴，則會檢查該文件是否是一個合法的圖像文件。 > 上傳錯誤提示信息支持多語言，你可以修改語言包來修改錯誤提示。 ## 上傳規則 默認情況下，會在上傳目錄下面生成以當前日期為子目錄，以微秒時間的`md5`編碼為文件名的文件，例如上面生成的文件名可能是： ``` /home/www/uploads/20160510/42a79759f284b767dfcb2a0197904287.jpg ``` 我們可以指定上傳文件的命名規則，使用`rule`方法即可，例如： ``` // 獲取表單上傳文件 例如上傳了001.jpg $file = request()->file('image'); // 移動到服務器的上傳目錄 并且使用md5規則 $file->rule('md5')->move('../uploads/'); ``` 最終生成的文件名類似于： ``` application/uploads/72/ef580909368d824e899f77c7c98388.jpg ``` 系統默認提供了幾種上傳命名規則，包括： 規則描述date根據日期和微秒數生成md5對文件使用md5\_file散列生成sha1對文件使用sha1\_file散列生成> 其中md5和sha1規則會自動以散列值的前兩個字符作為子目錄，后面的散列值作為文件名。 如果需要使用自定義命名規則，可以在`rule`方法中傳入函數或者方法，例如： ``` // 獲取表單上傳文件 例如上傳了001.jpg $file = request()->file('image'); // 移動到服務器的上傳目錄 并且使用uniqid規則 $file->rule('uniqid')->move('../uploads/'); ``` 生成的文件名類似于： ``` application/uploads/573d3b6d7abe2.jpg ``` 如果你希望保留原文件名稱，可以使用： ``` // 獲取表單上傳文件 例如上傳了001.jpg $file = request()->file('image'); // 移動到服務器的上傳目錄 并且使用原文件名 $file->move('../uploads/',''); ``` 默認情況下，會覆蓋服務器上傳目錄下的同名文件，如果不希望覆蓋，可以使用： ``` // 獲取表單上傳文件 例如上傳了001.jpg $file = request()->file('image'); // 移動到服務器的上傳目錄 并且設置不覆蓋 $file->move('../uploads/',true,false); ``` ## 獲取文件hash散列值 可以獲取上傳文件的哈希散列值，例如： ``` // 獲取表單上傳文件 $file = request()->file('image'); // 移動到服務器的上傳目錄 并且使用原文件名 $upload = $file->move('/home/www/upload/'); // 獲取上傳文件的hash散列值 echo $upload->md5(); echo $upload->sha1(); ``` 可以統一使用hash方法獲取文件散列值 ``` // 獲取表單上傳文件 $file = request()->file('image'); // 移動到服務器的上傳目錄 并且使用原文件名 $upload = $file->move('/home/www/upload/'); // 獲取上傳文件的hash散列值 echo $upload->hash('sha1'); echo $upload->hash('md5'); ``` ## 返回對象 上傳成功后返回的仍然是一個`File`對象，除了File對象自身的方法外，并且可以使用`SplFileObject`的屬性和方法，便于進行后續的文件處理。