萬盛學電腦網

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

PHP 檔案上傳入門教學:表單設定、MIME 類型對照表、核心函數與流程

表單設定三要素

  1. method="post" - 檔案上傳必須使用 POST
  2. enctype="multipart/form-data" - 多部分表單編碼
  3. <input type="hidden" name="MAX_FILE_SIZE" value="100000"> - 客戶端建議限制 (非強制)

$_FILES 陣列結構

$_FILES['field_name'] = [
    'name'     => 'photo.jpg',      // 原始檔名
    'type'     => 'image/jpeg',     // 瀏覽器回報 MIME (不可信)
    'tmp_name' => '/tmp/phpA1b2C3', // 伺服器暫存路徑
    'error'    => 0,                // 錯誤代碼 (0=成功)
    'size'     => 102400            // 檔案大小 (位元組)
];

常見 MIME 類型對照表

分類MIME Type副檔名
文字text/html.html, .htm
text/plain.txt, .log
圖片image/gif.gif
image/jpeg.jpeg, .jpg
image/png.png
音訊audio/midi.mid, .midi
audio/wav.wav
影片video/quicktime.qt, .mov
video/mpeg.mpeg
應用程式application/pdf.pdf
application/msword.doc, .dot
application/vnd.ms-excel.xls
application/vnd.ms-powerpoint.ppt
application/zip.zip
application/rar.rar
application/xml.xml, .xsl
application/octet-stream.bin, .exe, .dll, .class

核心處理函數

  • is_uploaded_file($tmp_name):確認是 HTTP POST 上傳的檔案 (防偽造)
  • move_uploaded_file($tmp_name, $destination):移動暫存檔到永久位置 (自動檢查是否為上傳檔案)

基本上傳流程

<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $file = $_FILES['myfile'] ?? null;
    
    if (!$file || $file['error'] !== UPLOAD_ERR_OK) {
        $errors = [
            UPLOAD_ERR_INI_SIZE => '超過伺服器限制',
            UPLOAD_ERR_FORM_SIZE => '超過表單限制',
            UPLOAD_ERR_PARTIAL => '上傳不完整',
            UPLOAD_ERR_NO_FILE => '未選擇檔案',
        ];
        die($errors[$file['error']] ?? '上傳失敗');
    }
    
    // 簡單驗證:副檔名
    $allowedExt = ['jpg', 'jpeg', 'png', 'gif'];
    $ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
    if (!in_array($ext, $allowedExt)) {
        die('不支援的檔案格式');
    }
    
    // 移動到上傳目錄
    $uploadDir = __DIR__ . '/uploads/';
    if (!is_dir($uploadDir)) mkdir($uploadDir, 0755, true);
    
    $newName = uniqid('img_') . '.' . $ext;
    $dest = $uploadDir . $newName;
    
    if (move_uploaded_file($file['tmp_name'], $dest)) {
        echo "上傳成功!檔案:$dest";
    } else {
        echo "移動檔案失敗";
    }
}
?>

進階安全建議

  • 使用 finfo 檢測真實 MIME 型別,不信任 $_FILES['type']
  • 檔名重新命名,避免中文、特殊字元、路徑遍歷
  • 上傳目錄設定**不可執行** (Nginx/Apache 禁止 PHP 執行)
  • 病毒掃描整合 (ClamAV 等)
  • 限制同時上傳數量與總大小
copyright © 萬盛學電腦網 all rights reserved