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