上傳

上傳文件

ThinkPHP5.0對(duì)文件上傳的支持更加簡(jiǎn)單。

內(nèi)置的上傳只是上傳到本地服務(wù)器，上傳到遠(yuǎn)程或者第三方平臺(tái)的話需要自己擴(kuò)展。

假設(shè)表單代碼如下：

<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');
    
    // 移動(dòng)到框架應(yīng)用根目錄/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{
            // 上傳失敗獲取錯(cuò)誤信息
            echo $file->getError();
        }
    }
}

move方法成功的話返回的是一個(gè)\think\File對(duì)象，你可以對(duì)上傳后的文件進(jìn)行后續(xù)操作。

多文件上傳

如果你使用的是多文件上傳表單，例如：

<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){
        // 移動(dòng)到框架應(yīng)用根目錄/public/uploads/ 目錄下
        $info = $file->move(ROOT_PATH . 'public' . DS . 'uploads');
        if($info){
            // 成功上傳后 獲取上傳信息
            // 輸出 jpg
            echo $info->getExtension(); 
            // 輸出 42a79759f284b767dfcb2a0197904287.jpg
            echo $info->getFilename(); 
        }else{
            // 上傳失敗獲取錯(cuò)誤信息
            echo $file->getError();
        }    
    }
}

上傳驗(yàn)證

支持對(duì)上傳文件的驗(yàn)證，包括文件大小、文件類型和后綴：

public function upload(){
    // 獲取表單上傳文件 例如上傳了001.jpg
    $file = request()->file('image');
    // 移動(dòng)到框架應(yīng)用根目錄/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{
        // 上傳失敗獲取錯(cuò)誤信息
        echo $file->getError();
    }
}

getSaveName方法返回的是圖片的服務(wù)器文件地址，并不能直接用于圖片的URL地址，尤其在windows平臺(tái)上必須做轉(zhuǎn)換才能正常顯示圖片。

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

還有一個(gè)額外的自動(dòng)驗(yàn)證規(guī)則是，如果上傳的文件后綴是圖像文件后綴，則會(huì)檢查該文件是否是一個(gè)合法的圖像文件。

上傳規(guī)則

默認(rèn)情況下，會(huì)在上傳目錄下面生成以當(dāng)前日期為子目錄，以微秒時(shí)間的md5編碼為文件名的文件，例如上面生成的文件名可能是：

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

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

// 獲取表單上傳文件 例如上傳了001.jpg
$file = request()->file('image');
// 移動(dòng)到服務(wù)器的上傳目錄 并且使用md5規(guī)則
$file->rule('md5')->move('/home/www/upload/');

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

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

系統(tǒng)默認(rèn)提供了幾種上傳命名規(guī)則，包括：

其中md5和sha1規(guī)則會(huì)自動(dòng)以散列值的前兩個(gè)字符作為子目錄，后面的散列值作為文件名。

如果需要使用自定義命名規(guī)則，可以在rule方法中傳入函數(shù)或者方法，例如：

// 獲取表單上傳文件 例如上傳了001.jpg
$file = request()->file('image');
// 移動(dòng)到服務(wù)器的上傳目錄 并且使用uniqid規(guī)則
$file->rule('uniqid')->move('/home/www/upload/');

生成的文件名類似于：

/home/www/upload/573d3b6d7abe2.jpg

如果你希望保留原文件名稱，可以使用：

// 獲取表單上傳文件 例如上傳了001.jpg
$file = request()->file('image');
// 移動(dòng)到服務(wù)器的上傳目錄 并且使用原文件名
$file->move('/home/www/upload/','');

默認(rèn)情況下，會(huì)覆蓋服務(wù)器上傳目錄下的同名文件，如果不希望覆蓋，可以使用：

// 獲取表單上傳文件 例如上傳了001.jpg
$file = request()->file('image');
// 移動(dòng)到服務(wù)器的上傳目錄 并且設(shè)置不覆蓋
$file->move('/home/www/upload/',true,false);

獲取文件hash散列值

可以獲取上傳文件的哈希散列值，例如：

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

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

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

返回對(duì)象

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