CodeIgniter4 使用文件上傳類

在 CodeIgniter 中通過表單使用文件上傳功能將會比直接使用 PHP 的 $_FILES 數(shù)組更加簡單和安全。其將繼承 文件類 并獲取該類的所有功能。

注解

這和 CodeIgniter 的上一版本的文件上傳類不同。這次提供了一個原生接口及一些小功能來上傳文件。上傳類將在最終版的時提供。

訪問文件

所有文件

當(dāng)你上傳文件時，PHP 可以在本地使用全局?jǐn)?shù)組 $_FILES 來訪問這些文件。當(dāng)你同時上傳多個文件時，這個數(shù)組存在一些不可忽視的缺點和很多開發(fā)者沒有意識到的安全方面的潛在缺陷。CodeIgniter 通過一個公共接口來規(guī)范你對文件的使用，從而改善這些問題。

通過當(dāng)前的 IncomingRequest 實例來訪問文件。使用 getFiles() 方法來獲取本次請求中上傳的所有文件。方法將會返回由 CodeIgniter\HTTP\Files\UploadedFile 實例表示的文件數(shù)組:

$files = $this->request->getFiles();

當(dāng)然，有很多種方式來為文件 input 標(biāo)簽命名，除了最簡外任何其他任何命名方式都可能產(chǎn)生奇怪的結(jié)果。數(shù)組將會以你期望的方式返回。使用最簡方式，一個單文件提交表單可能會是這樣:

<input type="file" name="avatar" />

其將會返回一個簡單的數(shù)組像是:

[
        'avatar' => // UploadedFile instance
]

如果你在標(biāo)簽名稱中使用數(shù)組表示法，input 標(biāo)簽將看上去像是這樣:

<input type="file" name="my-form[details][avatar]" />

getFiles() 方法返回的數(shù)組看上去將像是這樣:

[
        'my-form' => [
                'details' => [
                        'avatar' => // UploadedFile instance
                ]
        ]
]

在某些情況下，你可以指定一組文件元素來上傳:

Upload an avatar: <input type="file" name="my-form[details][avatars][]" />
Upload an avatar: <input type="file" name="my-form[details][avatars][]" />

在這種情況下，返回的文件數(shù)組將會像是這樣:

[
        'my-form' => [
                'details' => [
                        'avatar' => [
                                0 => /* UploadedFile instance */,
                                1 => /* UploadedFile instance */
                ]
        ]
]

單個文件

如果你只需要訪問單個文件，你可以使用 getFile() 方法來直接獲取文件實例。其將會返回一個 CodeIgniter\HTTP\Files\UploadedFile 實例:

最簡使用

使用最簡方式，一個單文件提交表單可能會是這樣:

<input type="file" name="userfile" />

其將會返回一個簡單的文件實例像是:

$file = $this->request->getFile('userfile');

數(shù)組表示法

如果你在標(biāo)簽名稱中使用數(shù)組表示法，input 標(biāo)簽將看上去像是這樣:

<input type="file" name="my-form[details][avatar]" />

這樣來獲取文件實例:

$file = $this->request->getFile('my-form.details.avatar');

多文件

<input type="file" name="images[]" multiple />

在控制器中::

if($imagefile = $this->request->getFiles()) {


    foreach($imagefile[‘images’] as $img) {


        if ($img->isValid() && ! $img->hasMoved()) {


            $newName = $img->getRandomName(); $img->move(WRITEPATH.’uploads’, $newName);
        }


    }


}

循環(huán)中的 images 是表單中的字段名稱

如果多個文件使用相同名稱提交，你可以使用 getFile() 去逐個獲取每個文件:: 在控制器中:

$file1 = $this->request->getFile('images.0');
$file2 = $this->request->getFile('images.1');

另外一個例子:

Upload an avatar: <input type="file" name="my-form[details][avatars][]" />
Upload an avatar: <input type="file" name="my-form[details][avatars][]" />

在控制器中:

$file1 = $this->request->getFile('my-form.details.avatars.0');
$file2 = $this->request->getFile('my-form.details.avatars.1');

注解

使用 getFiles() 更合適。

使用文件

一旦你獲取到了 UploadedFile 實例,你可以以安全的方式檢索到文件的信息，還能將文件移動到新的位置。

驗證文件

你可以調(diào)用 isValid() 方法來檢查文件是否是通過 HTTP 無誤上傳的:

if (! $file->isValid())
{
        throw new RuntimeException($file->getErrorString().'('.$file->getError().')');
}

如這個例子所見，如果一個文件產(chǎn)生一個上傳錯誤，你可以通過 getError() 和 getErrorString() 方法獲取錯誤碼（一個整數(shù)）和錯誤消息。通過此方法可以發(fā)現(xiàn)以下錯誤:

• 文件大小超過了 upload_max_filesize 配置的值。
• 文件大小超過了表單定義的上傳限制。
• 文件僅部分被上傳。
• 沒有文件被上傳。
• 無法將文件寫入磁盤。
• 無法上傳文件：缺少臨時目錄。
• PHP擴(kuò)展阻止了文件上傳。

文件名稱

getName()

你可以通過 getName() 提取到客戶端提供的文件的原始名稱。其通常是由客戶端發(fā)送的文件名，不應(yīng)受信。如果文件已經(jīng)被移動，將返回移動文件的最終名稱:

$name = $file->getName();

getClientName()

總是返回由客戶端發(fā)送的上傳文件的原始名稱，即使文件已經(jīng)被移動了:

$originalName = $file->getClientName();

getTempName()

要獲取在上傳期間產(chǎn)生的臨時文件的全路徑，你可以使用 getTempName() 方法:

$tempfile = $file->getTempName();

其他文件信息

getClientExtension()

基于上傳文件的名稱，返回原始文件擴(kuò)展名。這不是一個值得信賴的來源。對于可信的版本，請使用 getExtension() 來代替:

$ext = $file->getClientExtension();

getClientType()

返回由客戶端提供的文件的媒體類型(mime type)。這不是一個值得信賴的值，對于可信的版本，請使用 getType() 來代替:

$type = $file->getClientType();


echo $type; // image/png

移動文件

每個文件都可以使用恰如其名的 move() 方法來移動到新的位置。使用第一個參數(shù)為目標(biāo)目錄來移動文件:

$file->move(WRITEPATH.'uploads');

默認(rèn)的，將使用文件原始名稱。你可以指定一個新的文件名稱作為第二個參數(shù)傳遞給方法。

$newName = $file-&getRandomName(); $file-&move(WRITEPATH.’uploads’, $newName);

一旦文件被移除，將刪除臨時文件。你可以通過 hasMoved() 方法來檢查文件是否已經(jīng)被移動了，返回布爾值:

if ($file->isValid() && ! $file->hasMoved())
{
    $file->move($path);
}