PHP อัปโหลดไฟล์อย่างปลอดภัย
การอัปโหลดไฟล์เป็นจุดที่พลาดแล้วอันตราย — ถ้าปล่อยให้ผู้ใช้อัป .php เข้า webroot แล้วเปิดได้ เท่ากับยกเครื่องให้เขา
ฟอร์มอัปโหลด
<form method="post" action="/upload" enctype="multipart/form-data">
<input type="file" name="avatar" accept="image/*">
<button>อัปโหลด</button>
</form>ต้องมี enctype="multipart/form-data" และ method="post" ไม่งั้นไฟล์ไม่ถูกส่ง
$_FILES
<?php
// $_FILES['avatar'] มีหน้าตา:
[
'name' => 'photo.jpg', // ชื่อเดิม (ผู้ใช้ตั้ง — ห้ามเชื่อ)
'type' => 'image/jpeg', // MIME ที่เบราว์เซอร์อ้าง (ปลอมได้ — ห้ามเชื่อ)
'tmp_name' => '/tmp/phpA1B2C3', // path ชั่วคราวบนเซิร์ฟเวอร์
'error' => 0, // 0 = สำเร็จ
'size' => 245678, // ไบต์
]ตรวจแบบครบขั้น
<?php
declare(strict_types=1);
const MAX_SIZE = 2 * 1024 * 1024; // 2 MB
const ALLOWED = [
'image/jpeg' => 'jpg',
'image/png' => 'png',
'image/webp' => 'webp',
];
const UPLOAD_DIR = __DIR__ . '/../storage/uploads'; // นอก webroot!
/**
* @return array{ok: true, path: string}|array{ok: false, error: string}
*/
function handleAvatarUpload(array $file): array
{
// 1. มีไฟล์ และไม่มี error
if (($file['error'] ?? UPLOAD_ERR_NO_FILE) !== UPLOAD_ERR_OK) {
return ['ok' => false, 'error' => uploadErrorMessage($file['error'] ?? -1)];
}
// 2. เป็นไฟล์ที่อัปโหลดมาจริง (กันการหลอกให้อ่านไฟล์ระบบ)
if (!is_uploaded_file($file['tmp_name'])) {
return ['ok' => false, 'error' => 'ไฟล์ไม่ถูกต้อง'];
}
// 3. ขนาด
if ($file['size'] > MAX_SIZE) {
return ['ok' => false, 'error' => 'ไฟล์ใหญ่เกิน 2 MB'];
}
// 4. ตรวจชนิด "จริง" จากเนื้อไฟล์ ไม่ใช่ $file['type']
$finfo = new finfo(FILEINFO_MIME_TYPE);
$mime = $finfo->file($file['tmp_name']);
if (!isset(ALLOWED[$mime])) {
return ['ok' => false, 'error' => "ชนิดไฟล์ไม่รองรับ ($mime)"];
}
// 5. (แนะนำสำหรับรูป) ยืนยันว่าเป็นรูปเปิดได้จริง
if (@getimagesize($file['tmp_name']) === false) {
return ['ok' => false, 'error' => 'ไฟล์รูปเสียหาย'];
}
// 6. ตั้งชื่อใหม่เอง — อย่าใช้ชื่อจากผู้ใช้
$ext = ALLOWED[$mime];
$name = bin2hex(random_bytes(16)) . '.' . $ext;
$dest = UPLOAD_DIR . '/' . $name;
if (!is_dir(UPLOAD_DIR)) {
mkdir(UPLOAD_DIR, 0755, true);
}
// 7. ย้ายด้วย move_uploaded_file (ไม่ใช่ rename/copy)
if (!move_uploaded_file($file['tmp_name'], $dest)) {
return ['ok' => false, 'error' => 'บันทึกไฟล์ไม่สำเร็จ'];
}
return ['ok' => true, 'path' => $name];
}
function uploadErrorMessage(int $code): string
{
return match ($code) {
UPLOAD_ERR_INI_SIZE, UPLOAD_ERR_FORM_SIZE => 'ไฟล์ใหญ่เกินกำหนด',
UPLOAD_ERR_PARTIAL => 'อัปโหลดไม่ครบ',
UPLOAD_ERR_NO_FILE => 'ยังไม่ได้เลือกไฟล์',
UPLOAD_ERR_NO_TMP_DIR => 'เซิร์ฟเวอร์ไม่มีโฟลเดอร์ชั่วคราว',
UPLOAD_ERR_CANT_WRITE => 'เขียนดิสก์ไม่ได้',
default => 'อัปโหลดล้มเหลว',
};
}ใช้งาน:
<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
$result = handleAvatarUpload($_FILES['avatar'] ?? []);
if ($result['ok']) {
// เก็บ $result['path'] ลง DB ผูกกับ user
echo "อัปโหลดสำเร็จ: {$result['path']}\n";
} else {
echo "ผิดพลาด: {$result['error']}\n";
}
}ทำไมแต่ละขั้นสำคัญ
$file['type']ปลอมได้ — เบราว์เซอร์ (หรือ curl) ส่งอะไรมาก็ได้ ต้องอ่าน magic bytes ด้วยfinfois_uploaded_file()/move_uploaded_file()— PHP เช็คว่าtmp_nameมาจาก HTTP upload จริง ป้องกันการส่งtmp_name=/etc/passwdมา- ตั้งชื่อใหม่ — ชื่อจากผู้ใช้อาจมี
../,.php, อักขระแปลก หรือชนกับไฟล์เดิม - เก็บนอก webroot — ถ้าไฟล์อยู่ใน
public/แล้วเป็น.php(หรือ.phtml,.php5) เว็บเซิร์ฟเวอร์อาจรันมัน — เก็บในstorage/แล้วเสิร์ฟผ่าน PHP script ที่ตรวจสิทธิ์
เสิร์ฟไฟล์ที่อยู่นอก webroot
<?php
// /avatar.php?id=abc123
declare(strict_types=1);
$name = basename($_GET['id'] ?? ''); // basename กัน path traversal
$path = __DIR__ . '/../storage/uploads/' . $name;
if (!is_file($path)) {
http_response_code(404);
exit;
}
// (ตรวจสิทธิ์ตรงนี้ถ้าไฟล์เป็นส่วนตัว)
$mime = (new finfo(FILEINFO_MIME_TYPE))->file($path);
header('Content-Type: ' . $mime);
header('Content-Length: ' . filesize($path));
header('Content-Disposition: inline; filename="' . $name . '"');
readfile($path);จำกัดขนาดในหลายชั้น
php.ini (ถ้าเกินค่าพวกนี้ PHP ปัดตกก่อนโค้ดเราจะได้ทำงาน):
upload_max_filesize = 5M
post_max_size = 8M ; ต้อง >= upload_max_filesize + เผื่อ field อื่น
max_file_uploads = 20โค้ดเราเช็ค $file['size'] อีกชั้นเพื่อกฎที่เข้มกว่า และให้ข้อความ error ที่ดีกว่า
หลายไฟล์พร้อมกัน
<input type="file" name="photos[]" multiple>$_FILES['photos'] จะเป็นอาร์เรย์ที่ สลับมิติ — วนแบบนี้:
<?php
$files = $_FILES['photos'] ?? null;
if ($files) {
$count = count($files['name']);
for ($i = 0; $i < $count; $i++) {
$one = [
'name' => $files['name'][$i],
'type' => $files['type'][$i],
'tmp_name' => $files['tmp_name'][$i],
'error' => $files['error'][$i],
'size' => $files['size'][$i],
];
$result = handleAvatarUpload($one);
// ...
}
}เรื่องที่คนมักพลาด
- เชื่อ
$_FILES['x']['type']หรือนามสกุลไฟล์ เพื่อตัดสินชนิด — ปลอมทั้งคู่ ใช้finfoอ่านเนื้อไฟล์ - ใช้
move_uploaded_fileด้วยชื่อเดิมจากผู้ใช้ — path traversal (../../public/shell.php) หรือเขียนทับไฟล์ - เก็บไฟล์อัปโหลดใน
public/uploads/โดยไม่ปิดการรัน script — อัป webshell ได้ - ไม่เช็ค
$file['error']—UPLOAD_ERR_NO_FILEแล้วโค้ดพยายาม process ไฟล์ที่ไม่มี - ลืมว่า
post_max_sizeถูกเกิน —$_POSTและ$_FILESว่างทั้งคู่ ไม่มี error ชัด ๆ เช็ค$_SERVER['CONTENT_LENGTH']เทียบ getimagesize()= ปลอดภัย 100% — ช่วยกรองไฟล์ที่ไม่ใช่รูป แต่ไฟล์รูปก็ฝัง payload ได้ ถ้าซีเรียส ให้ประมวลผลรูปใหม่ (re-encode) ด้วย GD/Imagick- ตั้งสิทธิ์โฟลเดอร์ upload เป็น 0777 — ให้ 0755 พอ, ไฟล์ 0644
สรุป
- ต้องมี
enctype="multipart/form-data"+method="post" - เช็คตามลำดับ:
error === UPLOAD_ERR_OK→is_uploaded_file()→ ขนาด →finfoอ่านชนิดจริง → (รูป)getimagesize()→ ตั้งชื่อใหม่ด้วยrandom_bytes→move_uploaded_file() - เก็บไฟล์ นอก webroot (
storage/) เสิร์ฟผ่าน PHP script ที่basename()+ ตรวจสิทธิ์ - จำกัดขนาดทั้งใน
php.ini(upload_max_filesize,post_max_size) และในโค้ด - อย่าเชื่อ
name/typeจากผู้ใช้เลย
บทถัดไปว่าด้วยการทำงานกับไฟล์และไดเรกทอรีทั่วไป — อ่าน/เขียนไฟล์, __DIR__, การไล่โฟลเดอร์, และการอ่าน CSV