萬盛學電腦網

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

PHP 檔案上傳入門範例:基礎流程、錯誤碼處理、安全檢查與進階改進

最簡單上傳流程

<!-- upload.html -->
<form action="upload.php" method="post" enctype="multipart/form-data">
  <input type="file" name="upfile" id="myfile" required>
  <button type="submit" name="submit">上傳</button>
</form>
<?php
// upload.php
header('Content-Type: text/html; charset=utf-8');

if (!empty($_FILES)) {
    $file = $_FILES['upfile'];

    // 1. 檢查錯誤碼
    if ($file['error'] !== UPLOAD_ERR_OK) {
        $msgs = [
            UPLOAD_ERR_INI_SIZE => '超過 php.ini upload_max_filesize',
            UPLOAD_ERR_FORM_SIZE => '超過表單 MAX_FILE_SIZE',
            UPLOAD_ERR_PARTIAL => '上傳不完整',
            UPLOAD_ERR_NO_FILE => '未選擇檔案',
            UPLOAD_ERR_NO_TMP_DIR => '缺少暫存目錄',
            UPLOAD_ERR_CANT_WRITE => '寫入磁碟失敗',
            UPLOAD_ERR_EXTENSION => '擴展阻擋上傳',
        ];
        die('上傳失敗:' . ($msgs[$file['error']] ?? '未知錯誤'));
    }

    // 2. 產生唯一檔名
    $date = date('YmdHis');
    $ext = pathinfo($file['name'], PATHINFO_EXTENSION);
    $newName = $date . '_' . bin2hex(random_bytes(8)) . '.' . $ext;
    $dest = __DIR__ . '/uploads/' . $newName;

    // 3. 確保目錄存在
    if (!is_dir(__DIR__ . '/uploads')) {
        mkdir(__DIR__ . '/uploads', 0755, true);
    }

    // 4. 移動檔案
    if (move_uploaded_file($file['tmp_name'], $dest)) {
        echo "上傳成功!
"; echo "暫存路徑:{$file['tmp_name']}
"; echo "儲存位置:$dest"; } else { echo "移動檔案失敗,請檢查權限"; } } ?>

安全性必要檢查(必加)

<?php
// 允許的 MIME 類型
$allowedMime = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
$finfo = new finfo(FILEINFO_MIME_TYPE);
$mime = $finfo->file($file['tmp_name']);

if (!in_array($mime, $allowedMime, true)) {
    die('禁止的檔案類型');
}

// 限制檔案大小(雙重保障)
if ($file['size'] > 2 * 1024 * 1024) {
    die('檔案超過 2MB 限制');
}

// 圖片二次驗證(防偽裝腳本)
$imgInfo = @getimagesize($file['tmp_name']);
if (!$imgInfo) {
    die '非合法圖片檔案';
}

// 可選:重新處理圖片(移除 EXIF、壓縮、統一尺寸)
$image = imagecreatefromstring(file_get_contents($file['tmp_name']));
imagejpeg($image, $dest, 85);
imagedestroy($image);

常見 $_FILES 錯誤碼對照

常數值說明
UPLOAD_ERR_OK0成功
UPLOAD_ERR_INI_SIZE1超過 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_EXTENSION8PHP 擴展阻擋

進階:多檔案上傳

<input type="file" name="files[]" multiple>

<?php
foreach ($_FILES['files']['tmp_name'] as $idx => $tmpName) {
    if ($_FILES['files']['error'][$idx] === UPLOAD_ERR_OK) {
        // 處理單檔...
    }
}
?>

原始碼問題提醒

  • 原範例未檢查 $_FILES['upfile']['error']
  • 直接使用用戶檔名 $fileinfo['name'],有路徑遍歷、覆蓋風險
  • 未驗證檔案類型、大小
  • 目錄權限 0777 風險

原始來源:www.111cn.net

copyright © 萬盛學電腦網 all rights reserved