RUANG BACA DIGITAL BERBAHASA INDONESIA Dikelola PT. PENA DESA MEDIA

Upload gambar di PHP: periksa sebelum menyimpan

Lapisan validasi upload gambar: hak akses, status unggahan, ukuran, tipe isi, nama berkas, penyimpanan, dan respons aman.

Ilustrasi editorial untuk memperkenalkan topik, bukan dokumentasi pengujian.

Mulai dari siapa yang boleh mengunggah

Sebelum memikirkan ekstensi, tentukan hak unggah. Form publik tanpa batas dapat menghabiskan ruang disk atau menjadi tempat penyimpanan berkas yang tidak Anda inginkan. Gunakan autentikasi bila fitur hanya untuk penulis, verifikasi hak akses, dan lindungi tindakan pengguna dari pemalsuan permintaan sesuai arsitektur aplikasi.

Batasi jumlah unggahan serta kapasitas per akun. Catat kejadian penting tanpa menyimpan isi rahasia ke log. Batas pada browser membantu pengalaman pengguna, tetapi pembatasan yang benar tetap harus ada di sisi server. Rekomendasi OWASP menekankan perlindungan berlapis, bukan satu filter ekstensi [1].

Periksa hasil proses unggah sebelum membaca berkas

PHP memberi status error untuk unggahan. Jangan menganggap array $_FILES selalu lengkap atau selalu berisi bentuk yang diharapkan. Permintaan yang melewati batas server juga dapat membuat data form tidak tersedia sebagaimana biasanya.

$file = $_FILES['image'] ?? null;
if (!is_array($file) || !isset($file['error'])
    || !is_int($file['error'])
    || $file['error'] !== UPLOAD_ERR_OK) {
    http_response_code(400);
    exit('Unggahan tidak dapat diproses.');
}
if (!isset($file['tmp_name']) || !is_string($file['tmp_name'])
    || !is_uploaded_file($file['tmp_name'])) {
    http_response_code(400);
    exit('Berkas unggahan tidak valid.');
}

Cuplikan ini hanya menunjukkan pemeriksaan awal, bukan endpoint lengkap. Autentikasi, pembatasan permintaan, penanganan ukuran, validasi isi, dan penyimpanan belum ditambahkan. Jangan menaruhnya sendiri di internet lalu menganggap fitur upload sudah aman.

Jangan percaya satu ciri berkas

Periksa ukuran berkas yang benar-benar diterima. Cocokkan tipe isi menggunakan fasilitas server, batasi pada jenis gambar yang memang dibutuhkan, dan tolak tipe lain. Ekstensi dan header dari klien boleh membantu pemeriksaan pengalaman pengguna, tetapi bukan sumber kepercayaan.

Gambar juga mempunyai dimensi dan biaya decoding. File terkompresi yang kecil dapat membutuhkan memori besar setelah dibuka. Tentukan batas lebar, tinggi, jumlah piksel, dan waktu proses yang masuk akal sebelum melakukan transformasi berat. Jangan menerima SVG hanya karena dianggap gambar; kontennya berbeda dari raster JPEG atau PNG.

Jika melakukan decode dan encode ulang, gunakan pustaka yang dipelihara serta proses yang dibatasi sumber dayanya. Transformasi tersebut membantu pengendalian format, tetapi tidak menggantikan pembaruan keamanan pustaka. OWASP juga mengingatkan bahwa validasi tanda berkas tidak cukup jika berdiri sendiri [1].

Nama dan lokasi penyimpanan adalah keputusan keamanan

Gunakan nama yang dibuat server, misalnya pengenal acak ditambah ekstensi hasil validasi. Simpan nama asli sebagai metadata yang dibatasi panjangnya jika memang diperlukan. Jangan merangkai nama asli pengguna langsung menjadi path penyimpanan.

Penyimpanan di luar webroot mengurangi kemungkinan berkas dijalankan atau diambil langsung. Bila gambar perlu diakses publik, layani melalui pemetaan yang terkontrol atau direktori yang dipastikan tidak mengeksekusi skrip. Konfigurasi tepatnya bergantung pada web server dan pengaturan hosting; mematikan indeks direktori saja tidak mencegah eksekusi PHP.

Gunakan operasi pemindahan berkas unggahan yang sesuai, cek hasilnya, dan jangan melaporkan sukses jika penulisan gagal. Hindari menimpa nama yang sudah ada secara tidak sengaja. Bersihkan file sementara ketika proses gagal pada tahap berikutnya.

Uji penolakan, bukan hanya satu foto yang berhasil

UjiHasil yang diharapkan
Tidak ada filePesan terarah tanpa error mentah.
Ukuran melewati batasDitolak tanpa menulis file permanen.
Ekstensi gambar tetapi isi bukan gambarDitolak oleh pemeriksaan isi.
Nama sangat panjang atau mengandung pathTidak dipakai sebagai alamat penyimpanan.
Pengguna tanpa hak unggahDitolak sebelum pemrosesan berat.
Disk tidak dapat ditulisGagal dengan aman, tanpa klaim sukses.

Gunakan berkas uji yang tidak berbahaya pada lingkungan yang Anda kuasai. Tidak perlu mencoba payload berisiko pada hosting produksi untuk membuktikan pemeriksaan dasar berjalan.

Jaga pesan error dan jejak audit

Tampilkan alasan yang dapat ditindaklanjuti, seperti “ukuran melewati batas” atau “format belum didukung”, tanpa membuka path internal. Simpan informasi teknis yang diperlukan pada log terlindungi. Pastikan foto privat tidak menjadi publik hanya karena unggahan berhasil.

Sebelum menyediakan fitur ini, timbang apakah website memang membutuhkannya. Media statis dengan pengelola tunggal mungkin lebih sederhana menerima gambar melalui alur penerbitan, bukan form publik. Baca pemisahan file privat dan rute publik untuk menghindari perlindungan yang salah sasaran.

BACAAN LANJUTAN

Rujukan untuk memeriksa konsepnya

Dokumentasi resmi dan standar di bawah membantu pembaca meninjau istilah serta langkah teknis. Tautan ini bukan klaim bahwa setiap contoh dalam artikel telah diuji di semua perangkat atau hosting.

Menemukan langkah yang kurang jelas?

Laporkan bagian artikel yang perlu diperbaiki agar redaksi dapat memeriksa informasi dan sumbernya.

Kirim koreksi ke redaksi