File couldn't be moved,資料庫記錄文件名但大小為空;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 為空,腳本邏輯判斷失效,出現「頁面無反應」。
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 ; 指定臨時目錄(需可寫、空間足、獨立分區更佳)
http {
client_max_body_size 100m; # 必須 ≥ post_max_size
# 可選:針對上傳接口單獨放大
# location /api/upload { client_max_body_size 500m; }
}
<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
<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>
phpinfo.php 檢查 upload_max_filesize、post_max_size 實際值。php.ini 後必須重啟 PHP-FPM / Apache / Nginx。upload_tmp_dir 目錄擁有者為 PHP 運行用戶,且磁盤空間充足。ob_start() 導致內存飆升。<?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() 驗證生效。