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 ด้วย finfo
  • is_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