上傳文件

ThinkPHP5.0對文件上(shang)傳的(de)支持更加簡單。

內置的上(shang)傳只(zhi)是(shi)上(shang)傳到本地服(fu)務器，上(shang)傳到遠程或者第三方平臺的話(hua)需要自(zi)己擴展。

假設表單(dan)代(dai)碼如下(xia)：

<form action="/index/index/upload" enctype="multipart/form-data" method="post">
<input type="file" name="image" /> <br> 
<input type="submit" value="上傳" /> 
</form> 

然后在控制器(qi)中(zhong)添加如下的代(dai)碼：

public function upload(){
    // 獲取表單上傳文件 例如上傳了001.jpg
    $file = request()->file('image');
    
    // 移(yi)動到(dao)框架應用(yong)根目錄/public/uploads/ 目錄下
    if($file){
        $info = $file->move(ROOT_PATH . 'public' . DS . 'uploads');
        if($info){
            // 成功上傳后(hou) 獲取上傳信息
            // 輸出(chu) jpg
            echo $info->getExtension();
            // 輸(shu)出 20160820/42a79759f284b767dfcb2a0197904287.jpg
            echo $info->getSaveName();
            // 輸出 42a79759f284b767dfcb2a0197904287.jpg
            echo $info->getFilename(); 
        }else{
            // 上傳失敗(bai)獲取錯誤信息
            echo $file->getError();
        }
    }
}

move方法成功的話返回的是一個\think\File對象，你可以對上傳后(hou)的文件進(jin)行(xing)后(hou)續操作。

多文件上傳

如果你使用的(de)是多文件(jian)上傳表單(dan)，例(li)如：

<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){
        // 移動(dong)到框(kuang)架應用根目(mu)錄/public/uploads/ 目(mu)錄下(xia)
        $info = $file->move(ROOT_PATH . 'public' . DS . 'uploads');
        if($info){
            // 成(cheng)功上傳后 獲取(qu)上傳信(xin)息
            // 輸出(chu) jpg
            echo $info->getExtension(); 
            // 輸出 42a79759f284b767dfcb2a0197904287.jpg
            echo $info->getFilename(); 
        }else{
            // 上(shang)傳失(shi)敗獲取錯誤信息
            echo $file->getError();
        }    
    }
}

上傳驗證

支持對上傳文(wen)件(jian)的驗證，包括文(wen)件(jian)大(da)小、文(wen)件(jian)類型和后綴：

public function upload(){
    // 獲取表單上傳文件 例(li)如上傳了001.jpg
    $file = request()->file('image');
    // 移動到(dao)框架應用根目(mu)錄(lu)/public/uploads/ 目(mu)錄(lu)下
    $info = $file->validate(['size'=>15678,'ext'=>'jpg,png,gif'])->move(ROOT_PATH . 'public' . DS . 'uploads');
    if($info){
        // 成(cheng)功上傳后(hou) 獲取上傳信息
        // 輸出(chu) jpg
        echo $info->getExtension();
        // 輸(shu)出(chu) 20160820/42a79759f284b767dfcb2a0197904287.jpg
        echo $info->getSaveName();
        // 輸出 42a79759f284b767dfcb2a0197904287.jpg
        echo $info->getFilename(); 
    }else{
        // 上(shang)傳失(shi)敗獲取錯誤信(xin)息
        echo $file->getError();
    }
}

getSaveName方法返(fan)回的(de)(de)是圖片(pian)的(de)(de)服務(wu)器文件地址，并不能直(zhi)接用于圖片(pian)的(de)(de)URL地址，尤其在windows平臺(tai)上(shang)必須做轉(zhuan)換才能正常顯示圖片(pian)。

如果上傳文件驗證不通過，則move方(fang)法(fa)返回false。

還(huan)有一(yi)個(ge)額外的自動驗證規(gui)則是，如果上傳的文(wen)(wen)件(jian)后綴是圖(tu)像文(wen)(wen)件(jian)后綴，則會檢查該文(wen)(wen)件(jian)是否是一(yi)個(ge)合法的圖(tu)像文(wen)(wen)件(jian)。

上傳規則

默認情況下，會在上傳目錄下面生成以當前日期為子目錄，以微秒時間的md5編碼(ma)為文件名(ming)的文件，例如上面(mian)生成(cheng)的文件名(ming)可能是：

/home/www/upload/20160510/42a79759f284b767dfcb2a0197904287.jpg

我們可以指定上傳文件的命名規則，使用rule方法即可，例如：

// 獲取(qu)表單(dan)上傳文件 例如上傳了(le)001.jpg
$file = request()->file('image');
// 移動到服務器的上傳(chuan)目(mu)錄 并(bing)且(qie)使用(yong)md5規則
$file->rule('md5')->move('/home/www/upload/');

最終生成的文件(jian)名類似于：

/home/www/upload/72/ef580909368d824e899f77c7c98388.jpg

系(xi)統(tong)默認提供(gong)了(le)幾種(zhong)上傳命名規(gui)則(ze)，包括(kuo)：

其中md5和(he)sha1規則會自(zi)動以散列值的前兩個字符作為子目錄(lu)，后(hou)面(mian)的散列值作為文件名(ming)。

如果需要使用自定義命名規則，可以在rule方(fang)法中(zhong)傳入函數(shu)或(huo)者(zhe)方(fang)法，例如：

// 獲取表單上傳文件(jian) 例如(ru)上傳了001.jpg
$file = request()->file('image');
// 移動(dong)到服務器的上傳目錄 并且使(shi)用(yong)uniqid規則
$file->rule('uniqid')->move('/home/www/upload/');

生成的文件名類似于：

/home/www/upload/573d3b6d7abe2.jpg

 如果你(ni)希(xi)望保(bao)留(liu)原(yuan)文件名稱(cheng)，可以使用：

// 獲取(qu)表(biao)單上傳(chuan)文件 例如上傳(chuan)了001.jpg
$file = request()->file('image');
// 移動到服(fu)務器的上傳目錄 并且(qie)使用原文(wen)件名(ming)
$file->move('/home/www/upload/','');

默(mo)認(ren)情況下(xia)，會覆(fu)蓋(gai)服務器上傳目(mu)錄(lu)下(xia)的同名文件，如果不希望覆(fu)蓋(gai)，可以(yi)使(shi)用：

// 獲(huo)取表單上傳文件 例(li)如上傳了001.jpg
$file = request()->file('image');
// 移動到服(fu)務(wu)器的(de)上傳目錄 并(bing)且(qie)設置不(bu)覆蓋(gai)
$file->move('/home/www/upload/',true,false);

獲取文件hash散列值

可(ke)以獲取上傳文(wen)件的哈希散列(lie)值，例如(ru)：

// 獲取表單(dan)上傳文(wen)件
$file = request()->file('image');
// 移動到服務器的上傳目錄 并且使用原文件(jian)名
$upload = $file->move('/home/www/upload/');
// 獲取(qu)上傳(chuan)文件的hash散列值
echo $upload->md5();
echo $upload->sha1();

v5.0.1以上版本可以統一使用hash方法獲取文件(jian)散列(lie)值(zhi)

// 獲(huo)取表單上傳(chuan)文件
$file = request()->file('image');
// 移動到(dao)服務(wu)器的上傳目錄 并且使用原文(wen)件名
$upload = $file->move('/home/www/upload/');
// 獲(huo)取上傳文件的hash散列值
echo $upload->hash('sha1');
echo $upload->hash('md5');

返回對象

上傳成功后返回的仍然是一個File對象，除了File對象自身的方法外，并且可以使用SplFileObject的屬(shu)性和方法，便于(yu)進行后續的文件處理。