上傳

上傳文件

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

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

假設表單代碼如下：

<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對象，你可以對上傳后的文件進行后續(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){
        // 移動到框架應用根目錄/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();
    }
}

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

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

還有一個額外的自動驗證規(guī)則是，如果上傳的文件后綴是圖像文件后綴，則會檢查該文件是否是一個合法的圖像文件。

上傳規(guī)則

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

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

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

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

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

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

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

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

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

// 獲取表單上傳文件 例如上傳了001.jpg
$file = request()->file('image');
// 移動到服務器的上傳目錄 并且使用uniqid規(guī)則
$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以上版本可以統(tǒng)一使用hash方法獲取文件散列值

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

返回對象

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