<form enctype="multipart/form-data" action="upload.php" method="post">
<input type="hidden" name="MAX_FILE_SIZE" value="100000">
<input name="userfile" type="file">
<input type="submit" value="上傳檔案">
</form>
enctype="multipart/form-data":必須,否則瀏覽器以 application/x-www-form-urlencoded 發送,伺服器無法解析檔案二進位資料。MAX_FILE_SIZE 隱藏欄位:僅為瀏覽器端建議,可被繞過,不可信任。真正限制在 PHP 端 upload_max_filesize。name="userfile":對應 $_FILES['userfile'] 索引鍵,可自訂。$_FILES 超全域陣列假設表單欄位名為 userfile:
| 鍵名 | 含義 | 範例 |
|---|---|---|
$_FILES['userfile']['name'] | 客戶端原始檔名 | photo.jpg |
$_FILES['userfile']['type'] | MIME 型別 (瀏覽器提供,不可信) | image/jpeg |
$_FILES['userfile']['size'] | 檔案大小 (位元組) | 24578 |
$_FILES['userfile']['tmp_name'] | 伺服器暫存檔完整路徑 | /tmp/phpA1B2C3 |
$_FILES['userfile']['error'] | 錯誤代碼 | 見下表 |
error 代碼對照表| 值 | 常數 | 說明 |
|---|---|---|
| 0 | UPLOAD_ERR_OK | 上傳成功 |
| 1 | UPLOAD_ERR_INI_SIZE | 超過 php.ini upload_max_filesize |
| 2 | UPLOAD_ERR_FORM_SIZE | 超過表單 MAX_FILE_SIZE |
| 3 | UPLOAD_ERR_PARTIAL | 僅部分上傳 (網路中斷) |
| 4 | UPLOAD_ERR_NO_FILE | 未選擇檔案 |
| 6 | UPLOAD_ERR_NO_TMP_DIR | 缺少暫存目錄 (PHP 5.0.3+) |
| 7 | UPLOAD_ERR_CANT_WRITE | 寫入磁碟失敗 (PHP 5.1.0+) |
| 8 | UPLOAD_ERR_EXTENSION | 擴展阻止上傳 (PHP 5.2.0+) |
<?php
$dest_dir = 'uploads/';
$dest = $dest_dir . date('Ymd') . '_' . basename($_FILES['userfile']['name']);
if (move_uploaded_file($_FILES['userfile']['tmp_name'], $dest)) {
chmod($dest, 0644); // 設定檔案權限
echo '上傳成功:' . $dest;
} else {
echo '上傳失敗,錯誤碼:' . $_FILES['userfile']['error'];
}
必須使用 move_uploaded_file(),它會驗證檔案確實為 HTTP POST 上傳,防止偽造路徑攻擊。切勿用 copy() 或 rename()。
| 指令 | 預設 | 建議生產值 | 說明 |
|---|---|---|---|
file_uploads | On | On | 總開關 |
upload_tmp_dir | 系統預設 | /var/tmp/php_upload | 暫存目錄,需可寫、獨立分區、設 noexec |
upload_max_filesize | 2M | 50M | 單檔上限,需搭配 post_max_size |
post_max_size | 8M | 60M | POST 總體大小,必須 ≥ upload_max_filesize |
max_file_uploads | 20 | 20 | 單次請求最大檔案數 (PHP 5.2.1+) |
max_input_time | 60 | 300 | 解析輸入資料最長秒數,大檔需調大 |
<input type="file" name="files[]" multiple>
<!-- 或多個同名欄位 -->
<input type="file" name="files[]">
<input type="file" name="files[]">
<?php
foreach ($_FILES['files']['tmp_name'] as $idx => $tmp_name) {
if ($_FILES['files']['error'][$idx] !== UPLOAD_ERR_OK) continue;
$name = basename($_FILES['files']['name'][$idx]);
$dest = $dest_dir . date('YmdHis') . '_' . $idx . '_' . $name;
move_uploaded_file($tmp_name, $dest);
}
finfo_file() 檢測真實 MIME,禁用 $_FILES['type']。jpg|png|gif|pdf|docx 等。md5(uniqid()).'.'.$ext,避免覆蓋、路徑遍歷、腳本執行。public_html 外,或設 nginx: location ~ \.php$ { deny all; }。clamscan 異步掃描。getimagesize() 驗證圖片真實尺寸。<?php
define('MAX_UPLOAD_FILES', 10);
define('MAX_FILE_SIZE', 5 * 1024 * 1024); // 5MB
define('UPLOAD_DIR', 'd:/uploads/');
$forbidden_ext = array('.php','.php3','.php4','.exe','.msi','.htaccess','.gz');
function safe_filename($name) {
$ext = strtolower(pathinfo($name, PATHINFO_EXTENSION));
$base = preg_replace('/[^a-z0-9_.-]/i', '_', pathinfo($name, PATHINFO_FILENAME));
return $base . '.' . $ext;
}
if ($_POST['action'] === 'upload') {
for ($i=1; $i<=MAX_UPLOAD_FILES; $i++) {
$f = 'file_'.$i;
if (!isset($_FILES[$f]) || $_FILES[$f]['error'] !== UPLOAD_ERR_OK) continue;
if ($_FILES[$f]['size'] > MAX_FILE_SIZE) { /* 記錄錯誤 */ continue; }
$ext = strtolower(pathinfo($_FILES[$f]['name'], PATHINFO_EXTENSION));
if (in_array('.'.$ext, $forbidden_ext)) { /* 記錄錯誤 */ continue; }
$new_name = safe_filename($_FILES[$f]['name']);
move_uploaded_file($_FILES[$f]['tmp_name'], UPLOAD_DIR . $new_name);
/* 記錄成功 */
}
}
遵循「不信任客戶端、伺服器端二次驗證、最小權限儲存」原則,構建安全可靠的檔案上傳功能。