深入理解PHP $_FILES：文件上傳的重要變數

隨著Web應用程序的普及，文件上傳逐漸成為Web開發中不可或缺的一部分。PHP提供了一整套關於文件上傳的函數和變數，為上傳文件提供了便利。其中最重要的變數之一就是 $_FILES 。

一、$_FILES概述

$_FILES是一個關聯數組，用於保存文件上傳相關的信息，包括文件名、文件類型、文件大小、文件在伺服器中臨時存儲的路徑等。它的鍵名和對應含義如下：

$_FILES['file']['name']      // 上傳文件的原始文件名
$_FILES['file']['type']      // 上傳文件的類型（MIME類型）
$_FILES['file']['tmp_name']  // 上傳文件在伺服器中臨時存儲的路徑
$_FILES['file']['error']     // 上傳文件時出現的錯誤代碼
$_FILES['file']['size']      // 上傳文件的大小

二、文件上傳示例

下面是一個簡單的文件上傳示例：

<form action="handle_upload.php" method="post" enctype="multipart/form-data">
  <input type="file" name="file">
  <input type="submit" value="Upload">
</form>

在上面的表單中，我們使用enctype=”multipart/form-data”使表單支持文件上傳。然後用戶選擇要上傳的文件，並通過提交表單將文件上傳到名為handle_upload.php的文件中。

在handle_upload.php文件中，我們首先檢查文件是否上傳成功，然後保存並處理它：

<?php
if ($_FILES['file']['error'] !== UPLOAD_ERR_OK) {
    die("Upload failed with error code " . $_FILES['file']['error']);
}

$uploadPath = './uploads/' . basename($_FILES['file']['name']);

if (!move_uploaded_file($_FILES['file']['tmp_name'], $uploadPath)) {
    die("Failed to move uploaded file.");
}

echo "File uploaded successfully.";
?>

上面的代碼首先檢查上傳文件時是否出錯（UPLOAD_ERR_OK代表上傳成功），然後使用move_uploaded_file函數將文件從臨時路徑移動到指定的上傳路徑。最後，我們輸出上傳成功的信息。

三、$_FILES常見應用

1. 多文件上傳

在上面的示例中，我們只允許用戶上傳一個文件。如果想支持多文件上傳，可以添加多個文件輸入欄位，並使用數組形式的文件鍵名：

<form action="handle_upload.php" method="post" enctype="multipart/form-data">
  <input type="file" name="files[]" multiple>
  <input type="submit" value="Upload">
</form>

在handle_upload.php文件中，我們可以通過遍歷$_FILES[‘files’]數組來處理所有上傳的文件：

<?php
$uploadDir = './uploads/';

// 遍歷所有上傳的文件
for ($i = 0; $i < count($_FILES['files']['name']); $i++) {
    $filename = $_FILES['files']['name'][$i];
    $tmpName = $_FILES['files']['tmp_name'][$i];
    $filePath = $uploadDir . $filename;

    // 檢查文件是否上傳成功
    if ($_FILES['files']['error'][$i] !== UPLOAD_ERR_OK) {
        die("Upload failed with error code " . $_FILES['files']['error'][$i]);
    }

    // 移動文件
    if (!move_uploaded_file($tmpName, $filePath)) {
        die("Failed to move uploaded file.");
    }

    echo "File uploaded successfully.";
}
?>

2. 限制上傳的文件類型和大小

為了防止上傳惡意文件或超大文件，我們需要對文件類型和大小進行限制。我們可以使用$_FILES[‘file’][‘type’]來判斷上傳文件的類型，使用$_FILES[‘file’][‘size’]來判斷上傳文件的大小。

<?php
$allowTypes = array('image/jpeg', 'image/png', 'image/gif'); // 允許上傳的文件類型
$maxSize = 10 * 1024 * 1024; // 允許的最大文件大小，單位為位元組

if (in_array($_FILES['file']['type'], $allowTypes) && $_FILES['file']['size'] <= $maxSize) {
    // 上傳文件...
} else {
    echo "Invalid file type or file size too large.";
}
?>

3. 隨機生成文件名

為了避免上傳文件名衝突，我們可以使用隨機字元串來重命名上傳的文件。下面是一個簡單的例子，使用uniqid函數生成唯一字元串：

$filename = uniqid() . '_' . $_FILES['file']['name'];
$filePath = $uploadDir . $filename;

4. 獲取上傳文件的擴展名

假設我們想獲取上傳文件的擴展名，我們可以使用pathinfo函數來獲取文件路徑的信息，並使用其中的extension欄位：

$ext = pathinfo($_FILES['file']['name'], PATHINFO_EXTENSION);
$filename = uniqid() . '.' . $ext;

5. 其他變數

除了上面介紹的變數外，$_FILES還包含其他一些有用的變數，如CLIENT_FILENAME、CONTENT_LENGTH等。有興趣的讀者可以進一步了解。

總結

本文介紹了文件上傳時最重要的變數之一——$_FILES，包括它的概述、文件上傳示例以及常見應用。對於熟悉Web開發的讀者來說，文件上傳可能是一項非常基礎的技能，但對於初學者來說，掌握好文件上傳將會是他們Web開發學習的重要一步。