萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 入門級檔案上傳完整教學與 move_uploaded_file() 詳解

核心函數:move_uploaded_file()

bool move_uploaded_file(string $filename, string $destination)
  • 確認 $filename 是合法上傳檔案(透過 HTTP POST)。
  • 成功移動回傳 true,失敗回傳 false 並發出警告。
  • 非合法上傳檔案不執行任何操作,回傳 false。

HTML 表單必要屬性

<form enctype="multipart/form-data" action="" method="post">
  <input type="hidden" name="MAX_FILE_SIZE" value="102400"> <!-- 客戶端建議上限(位元組) -->
  <input type="file" name="fupload"><br>
  <input type="submit" value="上傳!">
</form>

重點:enctype="multipart/form-data" 必須設定,否則 $_FILES 為空。

最簡單上傳處理

<?php
if ($_FILES['fupload']['type'] === 'image/gif') {
    $source = $_FILES['fupload']['tmp_name'];
    $target = "upload/" . basename($_FILES['fupload']['name']);
    
    if (move_uploaded_file($source, $target)) {
        $size = getimagesize($target);
        echo "<p><img width='{$size[0]}' height='{$size[1]}' src='$target' alt='上傳圖片'></p>";
    } else {
        echo "上傳失敗";
    }
}
?>

完整上傳類別範例(含目錄自動建立、檔名重組、大小/類型限制)

<?php
// 設定區
$uploadDir = 'uploads/';
$maxSize = 2 * 1024 * 1024; // 2MB
$allowedTypes = ['image/jpeg', 'image/png', 'image/gif', 'application/pdf'];
$allowedExt = ['jpg', 'jpeg', 'png', 'gif', 'pdf'];

// 取得上傳資訊
$file = $_FILES['file'] ?? null;
if (!$file || $file['error'] !== UPLOAD_ERR_OK) {
    die('上傳錯誤代碼:' . ($file['error'] ?? '未知'));
}

// 檢查大小
if ($file['size'] > $maxSize) die('檔案過大(限制 2MB)');

// 檢查副檔名
$ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
if (!in_array($ext, $allowedExt, true)) die('不允許的副檔名');

// 檢查 MIME(參考用,可被偽造,建議搭配 finfo_file)
$finfo = finfo_open(FILEINFO_MIME_TYPE);
$mime = finfo_file($finfo, $file['tmp_name']);
finfo_close($finfo);
if (!in_array($mime, $allowedTypes, true)) die('不允許的檔案類型');

// 建立目錄
if (!is_dir($uploadDir)) {
    mkdir($uploadDir, 0755, true);
}

// 產生唯一檔名:日期時間 + 隨機數 + 原副檔名
$newName = date('YmdHis') . '_' . mt_rand(100000, 999999) . '.' . $ext;
$dest = $uploadDir . $newName;

// 移動檔案
if (move_uploaded_file($file['tmp_name'], $dest)) {
    $sizeKB = ceil(filesize($dest) / 1024);
    echo "上傳成功!<br>";
    echo "原始檔名:{$file['name']}<br>";
    echo "儲存路徑:$dest<br>";
    echo "檔案大小:{$sizeKB} KB<br>";
    echo "<a href='$dest' target='_blank'>檢視檔案</a>";
} else {
    echo "伺服器錯誤:無法移動檔案";
}
?>

上傳錯誤代碼對照表

常數值說明
UPLOAD_ERR_OK0上傳成功
UPLOAD_ERR_INI_SIZE1超過 php.ini upload_max_filesize
UPLOAD_ERR_FORM_SIZE2超過表單 MAX_FILE_SIZE
UPLOAD_ERR_PARTIAL3只上傳部分(網路中斷)
UPLOAD_ERR_NO_FILE4未選擇檔案
UPLOAD_ERR_NO_TMP_DIR6缺少暫存目錄
UPLOAD_ERR_CANT_WRITE7寫入磁碟失敗
UPLOAD_ERR_EXTENSION8被 PHP 擴充功能阻擋

安全性關鍵點

  1. 驗證 MIME 型別:使用 finfo_file() 而非只信任 $_FILES['type']。
  2. 重新命名檔案:避免覆蓋、路徑遍歷、腳本執行風險。
  3. 儲存於 Web 根目錄外:或以 .htaccess 禁止直接執行上傳目錄下的 PHP 檔。
  4. 限制副檔名白名單:拒絕 .php、.phtml、.php5 等可執行副檔名。
  5. 設定 php.ini:upload_max_filesize、post_max_size、max_file_uploads。
copyright © 萬盛學電腦網 all rights reserved