萬盛學電腦網

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

PHP 解決無法上傳超過 8MB 文件的完整排查方案

問題現象

  • 小文件上傳正常;
  • 稍大文件提示 File couldn't be moved,資料庫記錄文件名但大小為空;
  • 超過 8MB 文件頁面無任何響應(白屏、無錯誤、無跳轉)。

根因分析:預設值的「木桶效應」

PHP 預設配置中:

  • upload_max_filesize = 2M(單文件上限)
  • post_max_size = 8M(POST 總體上限)
  • memory_limit = 128M(腳本內存上限)
  • max_execution_time = 30(秒,執行超時)

當文件 > 2M 觸發 UPLOAD_ERR_INI_SIZE;當文件 > 8M 導致整個 POST 被截斷,$_FILES 為空,腳本邏輯判斷失效,出現「頁面無反應」。

完整解決方案:三層配置聯動

1. PHP 核心配置 php.ini

; === 文件上傳核心參數 ===
upload_max_filesize = 100M      ; 單文件上限
post_max_size = 100M            ; POST 總大小,必須 ≥ upload_max_filesize
max_execution_time = 300        ; 5分鐘超時,大文件需要更長時間
max_input_time = 300            ; 解析輸入數據時間
memory_limit = 256M             ; 腳本內存,大文件處理時可能佔用較多

; === 可選優化 ===
file_uploads = On               ; 確保開啟文件上傳
upload_tmp_dir = /tmp/php_uploads ; 指定臨時目錄(需可寫、空間足、獨立分區更佳)

2. Nginx 配置(若為代理架構)

http {
    client_max_body_size 100m;  # 必須 ≥ post_max_size
    # 可選:針對上傳接口單獨放大
    # location /api/upload { client_max_body_size 500m; }
}

3. Apache 配置(若直接跑 mod_php 或 php-fpm 代理)

<IfModule mod_php.c>
    php_value upload_max_filesize 100M
    php_value post_max_size 100M
    php_value max_execution_time 300
</IfModule>

# 或 .htaccess
php_value upload_max_filesize 100M
php_value post_max_size 100M

4. HTML 表單必要屬性

<form action="upload.php" method="post" enctype="multipart/form-data">
    <!-- 隱藏字段:瀏覽器端軟限制(可被繞過,僅作用戶提示) -->
    <input type="hidden" name="MAX_FILE_SIZE" value="104857600"> <!-- 100MB -->
    <input type="file" name="upload_file">
    <button type="submit">上傳</button>
</form>

進階排查清單(配置已改仍失效時)

  1. 確認配置生效:建立 phpinfo.php 檢查 upload_max_filesize、post_max_size 實際值。
  2. 重啟服務:修改 php.ini 後必須重啟 PHP-FPM / Apache / Nginx。
  3. 檢查臨時目錄權限:upload_tmp_dir 目錄擁有者為 PHP 運行用戶,且磁盤空間充足。
  4. 關閉輸出緩衝干擾:大文件上傳時避免 ob_start() 導致內存飆升。
  5. 前端分片上傳:>100MB 建議採用 Plupload、Uppy 等分片方案,突破單次請求限制。

代碼級防禦:上傳處理模板

<?php
function handleUpload(array $file): array {
    // 1. 錯誤碼檢查
    if ($file['error'] !== UPLOAD_ERR_OK) {
        throw new Exception("上傳失敗,錯誤碼:{$file['error']}");
    }

    // 2. 文件大小二次驗證(防繞過前端限制)
    $maxSize = 100 * 1024 * 1024; // 100MB
    if ($file['size'] > $maxSize) {
        throw new Exception('文件超過 100MB 限制');
    }

    // 3. 類型驗證(MIME + 擴展名雙重檢查)
    $allowedMimes = ['image/jpeg', 'image/png', 'application/pdf'];
    $finfo = finfo_open(FILEINFO_MIME_TYPE);
    $mime = finfo_file($finfo, $file['tmp_name']);
    if (!in_array($mime, $allowedMimes)) {
        throw new Exception('不支持的文件類型');
    }

    // 4. 安全移動
    $destDir = '/var/www/uploads/' . date('Y/m/d');
    if (!is_dir($destDir)) mkdir($destDir, 0755, true);
    $filename = bin2hex(random_bytes(16)) . '.' . pathinfo($file['name'], PATHINFO_EXTENSION);
    $destPath = $destDir . '/' . $filename;

    if (!move_uploaded_file($file['tmp_name'], $destPath)) {
        throw new Exception('文件保存失敗');
    }

    return ['path' => $destPath, 'size' => $file['size'], 'mime' => $mime];
}
?>

總結

「上傳 8M 失效」本質是 post_max_size 預設值 8M 導致 POST 數據被截斷。解決核心在於:**同步調大 Nginx client_max_body_size、PHP post_max_size/upload_max_filesize、執行時間限制**,並建立完善的錯誤碼處理與業務驗證機制。配置修改後務必 重啟服務並用 phpinfo() 驗證生效。

copyright © 萬盛學電腦網 all rights reserved