Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk

Blog / Dashboard Admin, CRUD & Frontend / Upload Gambar, Media Library,...
Dashboard Admin, CRUD & Frontend

Upload Gambar, Media Library, dan Image Preview: Panduan Pengelolaan Media Laravel

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
17 min read
13 views

Mengelola media dengan spatie/laravel-medialibrary v11: koleksi per model, konversi thumbnail dan WebP di queue, responsive images, galeri dengan urutan yang bisa diatur, media privat, serta antarmuka unggah dengan pratinjau, drag and drop, dan progres menggunakan Alpine.js.

Overview

Aplikasi RW memiliki beberapa kebutuhan media:

Kebutuhan Contoh
Satu gambar per entitas Foto profil warga, logo RW
Galeri berurutan Dokumentasi kegiatan kerja bakti, 1–30 foto
Dokumen privat Scan KK, bukti transfer
Ukuran berbeda Thumbnail untuk daftar, ukuran sedang untuk detail, WebP untuk web

Menangani semua ini secara manual (kolom foto_path, resize sendiri, hapus file lama) cepat menjadi rumit. Masalah umum:

  • file lama tidak terhapus saat foto diganti, disk penuh file yatim,
  • gambar asli 6 MB dari kamera ponsel ditampilkan di daftar sehingga halaman lambat,
  • proses resize dilakukan saat request sehingga upload terasa sangat lambat,
  • tidak ada pratinjau, pengguna tidak yakin foto yang dipilih sudah benar.

spatie/laravel-medialibrary mengaitkan file dengan model Eloquent mana pun, mengelola koleksi, membuat konversi, dan membersihkan file saat model atau media dihapus.

Hasil akhir:

  • media library terpasang dengan path file yang tidak bisa ditebak,
  • koleksi foto profil (satu file) dan galeri kegiatan (banyak file, berurutan),
  • konversi thumb dan web (WebP) yang diproses di queue,
  • media privat untuk dokumen sensitif, disajikan lewat controller berotorisasi,
  • komponen unggah dengan pratinjau, drag and drop, dan progres,
  • pengaturan urutan galeri dan penghapusan media,
  • test.

Prerequisites

Komponen Versi
PHP 8.3+ (disarankan 8.4), ekstensi gd atau imagick, exif, fileinfo
Laravel 13.x
spatie/laravel-medialibrary ^11.0
Queue Redis atau database, dengan worker berjalan
Alpine.js 3.x
Opsional jpegoptim, optipng, pngquant, cwebp untuk optimasi

Prinsip keamanan upload (validasi isi file, larangan eksekusi, disk privat) mengikuti artikel Panduan Mengelola File Upload Laravel agar Aman dari File Berbahaya.

Step-by-step Tutorial

Langkah 1: Instalasi

composer require "spatie/laravel-medialibrary:^11.0"
php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="medialibrary-migrations"
php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="medialibrary-config"
php artisan migrate

Paket membuat tabel media yang menyimpan metadata setiap file: model pemilik, koleksi, nama, disk, ukuran, tipe MIME, urutan, dan status konversi.

Pengaturan penting di config/media-library.php:

return [
    'disk_name' => env('MEDIA_DISK', 'public'),
    'max_file_size' => 1024 * 1024 * 8,                       // 8 MB
    'queue_connection_name' => env('QUEUE_CONNECTION', 'redis'),
    'queue_name' => 'media',
    'queue_conversions_by_default' => true,                   // konversi di queue
    'image_driver' => env('IMAGE_DRIVER', 'gd'),              // gd | imagick
    'path_generator' => \App\Support\Media\AcakPathGenerator::class,
    // ...
];

Langkah 2: Path yang Tidak Bisa Ditebak

Secara bawaan, file disimpan di folder bernama ID media (/storage/1/, /storage/2/, ...). Untuk media publik pun, path berurutan memudahkan orang menelusuri semua file. Gunakan path generator dengan UUID:

// app/Support/Media/AcakPathGenerator.php
namespace App\Support\Media;

use Spatie\MediaLibrary\MediaCollections\Models\Media;
use Spatie\MediaLibrary\Support\PathGenerator\PathGenerator;

class AcakPathGenerator implements PathGenerator
{
    public function getPath(Media $media): string
    {
        return $media->uuid.'/';
    }

    public function getPathForConversions(Media $media): string
    {
        return $media->uuid.'/konversi/';
    }

    public function getPathForResponsiveImages(Media $media): string
    {
        return $media->uuid.'/responsif/';
    }
}

Kolom uuid diisi otomatis oleh paket saat media dibuat.

Langkah 3: Daftarkan Koleksi dan Konversi di Model

// app/Models/Kegiatan.php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Spatie\Image\Enums\Fit;
use Spatie\MediaLibrary\{HasMedia, InteractsWithMedia};
use Spatie\MediaLibrary\MediaCollections\Models\Media;

class Kegiatan extends Model implements HasMedia
{
    use InteractsWithMedia;

    protected $fillable = ['judul', 'tanggal', 'deskripsi'];

    public function registerMediaCollections(): void
    {
        $this->addMediaCollection('sampul')
            ->singleFile()                                     // unggah baru menggantikan yang lama
            ->acceptsMimeTypes(['image/jpeg', 'image/png', 'image/webp'])
            ->useFallbackUrl('/images/kegiatan-default.webp');

        $this->addMediaCollection('galeri')
            ->acceptsMimeTypes(['image/jpeg', 'image/png', 'image/webp'])
            ->onlyKeepLatest(30)                               // batas jumlah foto
            ->withResponsiveImages();
    }

    public function registerMediaConversions(?Media $media = null): void
    {
        $this->addMediaConversion('thumb')
            ->fit(Fit::Crop, 400, 300)
            ->format('webp')
            ->quality(75)
            ->nonOptimized();

        $this->addMediaConversion('web')
            ->fit(Fit::Max, 1600, 1600)
            ->format('webp')
            ->quality(80);
    }
}
// app/Models/User.php (foto profil)
class User extends Authenticatable implements HasMedia
{
    use InteractsWithMedia;

    public function registerMediaCollections(): void
    {
        $this->addMediaCollection('foto')
            ->singleFile()
            ->acceptsMimeTypes(['image/jpeg', 'image/png', 'image/webp'])
            ->useFallbackUrl('/images/avatar-default.svg');
    }

    public function registerMediaConversions(?Media $media = null): void
    {
        $this->addMediaConversion('avatar')->fit(Fit::Crop, 160, 160)->format('webp');
    }
}

Konversi menghasilkan file baru dari gambar asli. Karena gambar dibaca dan ditulis ulang oleh pustaka gambar, metadata EXIF (termasuk lokasi GPS dari foto ponsel) tidak ikut ke file hasil konversi. File asli tetap disimpan; tampilkan konversi, bukan file asli, di halaman publik.

Langkah 4: Endpoint Unggah

Unggah dilakukan per file lewat AJAX, sehingga setiap file punya progres sendiri dan satu file gagal tidak membatalkan file lain.

// app/Http/Controllers/KegiatanMediaController.php
namespace App\Http\Controllers;

use App\Models\Kegiatan;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Gate;
use Illuminate\Support\Str;
use Illuminate\Validation\Rules\File;
use Illuminate\Validation\Rule;

class KegiatanMediaController extends Controller
{
    public function store(Request $request, Kegiatan $kegiatan)
    {
        Gate::authorize('update', $kegiatan);

        $data = $request->validate([
            'koleksi' => ['required', Rule::in(['sampul', 'galeri'])],
            'file'    => ['required', File::image()->types(['jpg', 'jpeg', 'png', 'webp'])->max(8 * 1024)
                            ->dimensions(Rule::dimensions()->maxWidth(8000)->maxHeight(8000)),
                          'extensions:jpg,jpeg,png,webp'],
            'judul'   => ['nullable', 'string', 'max:150'],
        ]);

        if ($data['koleksi'] === 'galeri' && $kegiatan->getMedia('galeri')->count() >= 30) {
            return response()->json(['message' => 'Galeri sudah berisi 30 foto.'], 422);
        }

        $media = $kegiatan->addMediaFromRequest('file')
            ->usingName($data['judul'] ?? Str::of($request->file('file')->getClientOriginalName())->beforeLast('.')->limit(100, ''))
            ->usingFileName(Str::uuid().'.'.$request->file('file')->extension())   // nama file acak
            ->withCustomProperties(['diunggah_oleh' => $request->user()->id])
            ->toMediaCollection($data['koleksi']);

        return response()->json($this->format($media), 201);
    }

    public function destroy(Kegiatan $kegiatan, int $mediaId)
    {
        Gate::authorize('update', $kegiatan);

        $media = $kegiatan->media()->findOrFail($mediaId);       // pastikan media milik kegiatan ini
        $media->delete();                                        // file asli & konversi ikut terhapus

        return response()->noContent();
    }

    public function reorder(Request $request, Kegiatan $kegiatan)
    {
        Gate::authorize('update', $kegiatan);

        $ids = $request->validate([
            'urutan'   => ['required', 'array', 'max:30'],
            'urutan.*' => ['integer', 'distinct'],
        ])['urutan'];

        // Hanya ID milik galeri kegiatan ini yang boleh diurutkan
        $valid = $kegiatan->getMedia('galeri')->pluck('id')->all();
        abort_if(array_diff($ids, $valid) !== [], 422, 'Urutan berisi media yang tidak valid.');

        \Spatie\MediaLibrary\MediaCollections\Models\Media::setNewOrder($ids);

        return response()->noContent();
    }

    private function format($media): array
    {
        return [
            'id'    => $media->id,
            'nama'  => $media->name,
            'thumb' => $media->getAvailableUrl(['thumb']),        // fallback ke asli bila konversi belum selesai
            'url'   => $media->getAvailableUrl(['web']),
            'siap'  => $media->hasGeneratedConversion('thumb'),
        ];
    }
}
// routes/web.php
Route::middleware(['auth', 'active'])->prefix('kegiatan/{kegiatan}/media')->name('kegiatan.media.')->group(function () {
    Route::post('/', [KegiatanMediaController::class, 'store'])->middleware('throttle:30,1')->name('store');
    Route::delete('{mediaId}', [KegiatanMediaController::class, 'destroy'])->whereNumber('mediaId')->name('destroy');
    Route::put('urutan', [KegiatanMediaController::class, 'reorder'])->name('reorder');
});

Poin penting:

  • ->usingFileName(Str::uuid()...) memastikan nama file di disk tidak memakai nama dari pengguna.
  • Penghapusan dan pengurutan memverifikasi bahwa media memang milik kegiatan tersebut. Tanpa pemeriksaan ini, pengguna bisa menghapus foto kegiatan lain dengan mengganti ID di request.
  • getAvailableUrl() memberi URL konversi bila sudah jadi, atau file asli bila konversi masih di queue.

Langkah 5: Komponen Unggah dengan Pratinjau dan Progres

fetch belum menyediakan progres unggah, sehingga komponen ini memakai XMLHttpRequest.

// resources/js/components/pengunggah-media.js
export default ({ url, koleksi = 'galeri', maks = 30, sudahAda = [] }) => ({
    item: sudahAda.map((m) => ({ ...m, status: 'selesai', progres: 100 })),
    seret: false,

    get sisa() {
        return maks - this.item.filter((i) => i.status !== 'gagal').length;
    },

    pilih(event) {
        this.tambahFile([...(event.target.files ?? event.dataTransfer?.files ?? [])]);
        if (event.target.value !== undefined) event.target.value = '';      // izinkan memilih file yang sama lagi
    },

    tambahFile(files) {
        const diizinkan = ['image/jpeg', 'image/png', 'image/webp'];

        files.slice(0, this.sisa).forEach((file) => {
            const entri = {
                kunci: crypto.randomUUID(),
                nama: file.name,
                pratinjau: URL.createObjectURL(file),     // pratinjau lokal, tanpa menunggu server
                progres: 0,
                status: 'menunggu',
                pesan: '',
            };

            if (!diizinkan.includes(file.type)) {
                Object.assign(entri, { status: 'gagal', pesan: 'Format harus JPG, PNG, atau WebP.' });
            } else if (file.size > 8 * 1024 * 1024) {
                Object.assign(entri, { status: 'gagal', pesan: 'Ukuran maksimal 8 MB.' });
            }

            this.item.push(entri);
            // Ambil versi reaktif (proxy) dari array; mengubah objek asli tidak memperbarui tampilan
            const reaktif = this.item[this.item.length - 1];
            if (reaktif.status === 'menunggu') this.unggah(file, reaktif);
        });
    },

    unggah(file, entri) {
        const data = new FormData();
        data.append('file', file);
        data.append('koleksi', koleksi);

        const xhr = new XMLHttpRequest();
        xhr.open('POST', url);
        xhr.setRequestHeader('Accept', 'application/json');
        xhr.setRequestHeader('X-CSRF-TOKEN', document.querySelector('meta[name="csrf-token"]').content);

        entri.status = 'mengunggah';
        xhr.upload.onprogress = (e) => {
            if (e.lengthComputable) entri.progres = Math.round((e.loaded / e.total) * 100);
        };

        xhr.onload = () => {
            const res = JSON.parse(xhr.responseText || '{}');
            if (xhr.status === 201) {
                URL.revokeObjectURL(entri.pratinjau);    // bebaskan memori
                Object.assign(entri, { ...res, status: 'selesai', pratinjau: res.thumb });
            } else {
                entri.status = 'gagal';
                entri.pesan = res.errors?.file?.[0] ?? res.message ?? 'Gagal mengunggah.';
            }
        };
        xhr.onerror = () => Object.assign(entri, { status: 'gagal', pesan: 'Koneksi terputus.' });

        xhr.send(data);
    },

    async hapus(entri) {
        if (entri.id && !confirm('Hapus foto ini?')) return;

        if (entri.id) {
            const res = await fetch(`${url}/${entri.id}`, {
                method: 'DELETE',
                headers: { 'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').content, Accept: 'application/json' },
            });
            if (!res.ok) return alert('Gagal menghapus foto.');
        }

        if (entri.pratinjau?.startsWith('blob:')) URL.revokeObjectURL(entri.pratinjau);
        this.item = this.item.filter((i) => i.kunci !== entri.kunci);
    },
});
// resources/js/app.js
import pengunggahMedia from './components/pengunggah-media';
Alpine.data('pengunggahMedia', pengunggahMedia);
{{-- resources/views/kegiatan/_galeri.blade.php --}}
<div x-data="pengunggahMedia(@js([
        'url'      => route('kegiatan.media.store', $kegiatan),
        'koleksi'  => 'galeri',
        'maks'     => 30,
        'sudahAda' => $kegiatan->getMedia('galeri')->map(fn ($m) => [
            'id' => $m->id, 'kunci' => 'm'.$m->id, 'nama' => $m->name, 'pratinjau' => $m->getAvailableUrl(['thumb']),
        ])->values(),
     ]))">

    <label x-on:dragover.prevent="seret = true" x-on:dragleave.prevent="seret = false"
           x-on:drop.prevent="seret = false; pilih($event)"
           :class="seret ? 'border-brand-500 bg-brand-50' : 'border-slate-300'"
           class="flex cursor-pointer flex-col items-center justify-center rounded-card border-2 border-dashed p-8 text-center">
        <span class="font-medium">Seret foto ke sini atau klik untuk memilih</span>
        <span class="mt-1 text-sm text-slate-500">JPG, PNG, atau WebP · maks. 8 MB · sisa <span x-text="sisa"></span> foto</span>
        <input type="file" class="sr-only" accept="image/jpeg,image/png,image/webp" multiple x-on:change="pilih($event)"
               :disabled="sisa <= 0">
    </label>

    <ul class="mt-4 grid grid-cols-2 gap-3 sm:grid-cols-4" aria-live="polite">
        <template x-for="entri in item" :key="entri.kunci">
            <li class="relative overflow-hidden rounded-lg border bg-white">
                <img :src="entri.pratinjau" :alt="entri.nama" class="aspect-[4/3] w-full object-cover"
                     :class="entri.status === 'mengunggah' && 'opacity-60'">

                <div x-show="entri.status === 'mengunggah'" class="absolute inset-x-0 bottom-0 h-1.5 bg-slate-200">
                    <div class="h-full bg-brand-500 transition-all" :style="`width: ${entri.progres}%`"></div>
                </div>

                <p x-show="entri.status === 'gagal'" class="p-2 text-xs text-red-600" x-text="entri.pesan"></p>

                <button type="button" x-on:click="hapus(entri)" x-show="entri.status !== 'mengunggah'"
                        class="absolute right-1 top-1 rounded-full bg-white/90 p-1 text-xs shadow" aria-label="Hapus foto">✕</button>
            </li>
        </template>
    </ul>
</div>

Catatan:

  • Pratinjau langsung dengan URL.createObjectURL() tanpa mengunggah dulu, lalu diganti dengan thumbnail dari server setelah selesai. Selalu panggil URL.revokeObjectURL() agar memori browser tidak bocor.
  • Validasi di browser hanya untuk kenyamanan. Server tetap memvalidasi tipe, ekstensi, ukuran, dan dimensi.
  • aria-live="polite" membuat pembaca layar mengumumkan perubahan daftar.
  • alt diisi nama file sebagai awal; sediakan kolom keterangan foto bila galeri ditampilkan untuk publik.

Langkah 6: Atur Urutan Galeri dengan Drag and Drop

Gunakan plugin resmi @alpinejs/sort:

npm install @alpinejs/sort
import sort from '@alpinejs/sort';
Alpine.plugin(sort);
<ul x-sort="simpanUrutan()" class="grid grid-cols-2 gap-3 sm:grid-cols-4">
    <template x-for="entri in item" :key="entri.kunci">
        <li x-sort:item="entri.id" class="cursor-move ..."> ... </li>
    </template>
</ul>
// tambahkan ke komponen pengunggahMedia
async simpanUrutan() {
    await this.$nextTick();
    const urutan = [...this.$root.querySelectorAll('[x-sort\\:item]')]
        .map((el) => Alpine.$data(el).entri.id)
        .filter(Boolean);

    await fetch(`${url}/urutan`, {
        method: 'PUT',
        headers: {
            'Content-Type': 'application/json', Accept: 'application/json',
            'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').content,
        },
        body: JSON.stringify({ urutan }),
    });
},

Server memverifikasi bahwa semua ID memang milik galeri kegiatan tersebut sebelum menyimpan urutan (Langkah 4).

Langkah 7: Menampilkan Media

{{-- Sampul dengan fallback --}}
<img src="{{ $kegiatan->getFirstMediaUrl('sampul', 'web') }}" alt="{{ $kegiatan->judul }}"
     class="aspect-video w-full rounded-card object-cover" loading="lazy">

{{-- Galeri dengan responsive images (srcset otomatis) --}}
<div class="grid grid-cols-2 gap-2 sm:grid-cols-3">
    @foreach ($kegiatan->getMedia('galeri') as $foto)
        <a href="{{ $foto->getAvailableUrl(['web']) }}" class="block overflow-hidden rounded-lg">
            {{ $foto->img('thumb', ['class' => 'aspect-[4/3] w-full object-cover', 'loading' => 'lazy', 'alt' => $foto->name]) }}
        </a>
    @endforeach
</div>

{{-- Avatar --}}
<img src="{{ $user->getFirstMediaUrl('foto', 'avatar') }}" alt="" class="size-10 rounded-full object-cover">

Untuk halaman daftar, eager load media agar tidak terjadi N+1:

$kegiatan = Kegiatan::with('media')->latest('tanggal')->paginate(12);

Langkah 8: Media Privat untuk Dokumen Sensitif

Dokumen seperti scan KK harus di disk privat dan disajikan lewat controller berotorisasi.

// app/Models/Keluarga.php
public function registerMediaCollections(): void
{
    $this->addMediaCollection('dokumen_kk')
        ->singleFile()
        ->useDisk('private')
        ->acceptsMimeTypes(['image/jpeg', 'image/png', 'application/pdf']);
}
// app/Http/Controllers/DokumenKkController.php
public function show(Keluarga $keluarga)
{
    Gate::authorize('viewDokumen', $keluarga);

    $media = $keluarga->getFirstMedia('dokumen_kk') ?? abort(404);

    activity('dokumen')->performedOn($keluarga)->causedBy(auth()->user())->log('Membuka dokumen KK');

    return response()->download($media->getPath(), 'kk-'.$keluarga->id.'.'.$media->extension, [
        'Content-Type'           => $media->mime_type,
        'X-Content-Type-Options' => 'nosniff',
        'Cache-Control'          => 'private, no-store',
    ]);
}

Untuk disk S3, gunakan $media->getTemporaryUrl(now()->addMinutes(5)) setelah otorisasi.

Langkah 9: Queue, Optimasi, dan Pembersihan

Jalankan worker untuk antrean media:

php artisan queue:work redis --queue=media,default --tries=3 --timeout=120

Optimasi gambar (opsional) memakai biner sistem bila tersedia:

sudo apt install jpegoptim optipng pngquant webp

Perintah pemeliharaan:

php artisan media-library:regenerate --only-missing     # buat konversi yang belum ada
php artisan media-library:regenerate "App\Models\Kegiatan" --only=thumb   # setelah mengubah definisi konversi
php artisan media-library:clean --dry-run               # cek file/konversi yatim tanpa menghapus
php artisan media-library:clean

Jadwalkan pembersihan berkala:

// routes/console.php
Schedule::command('media-library:clean')->weekly();

Langkah 10: Test

// tests/Feature/Media/KegiatanMediaTest.php
use Illuminate\Http\UploadedFile;
use Illuminate\Support\Facades\{Queue, Storage};

beforeEach(function () {
    Storage::fake('public');
    Queue::fake();
    $this->seed(\Database\Seeders\RolePermissionSeeder::class);
    $this->pengurus = User::factory()->create()->assignRole('pengurus');
    $this->kegiatan = Kegiatan::factory()->create();
});

it('mengunggah foto ke galeri dengan nama file acak', function () {
    $this->actingAs($this->pengurus)
        ->postJson(route('kegiatan.media.store', $this->kegiatan), [
            'koleksi' => 'galeri',
            'file' => UploadedFile::fake()->image('Kerja Bakti Minggu.jpg', 1200, 900),
        ])
        ->assertCreated()
        ->assertJsonStructure(['id', 'nama', 'thumb', 'url']);

    $media = $this->kegiatan->fresh()->getFirstMedia('galeri');
    expect($media->file_name)->not->toContain('Kerja Bakti')
        ->and($media->name)->toBe('Kerja Bakti Minggu');
});

it('menolak file yang bukan gambar', function () {
    $this->actingAs($this->pengurus)
        ->postJson(route('kegiatan.media.store', $this->kegiatan), [
            'koleksi' => 'galeri',
            'file' => UploadedFile::fake()->createWithContent('foto.jpg', '<?php echo 1;'),
        ])
        ->assertJsonValidationErrors('file');
});

it('sampul hanya menyimpan satu file', function () {
    foreach (['a.jpg', 'b.jpg'] as $nama) {
        $this->actingAs($this->pengurus)->postJson(route('kegiatan.media.store', $this->kegiatan), [
            'koleksi' => 'sampul', 'file' => UploadedFile::fake()->image($nama),
        ]);
    }

    expect($this->kegiatan->fresh()->getMedia('sampul'))->toHaveCount(1);
});

it('tidak bisa menghapus media milik kegiatan lain', function () {
    $lain = Kegiatan::factory()->create();
    $media = $lain->addMedia(UploadedFile::fake()->image('x.jpg'))->toMediaCollection('galeri');

    $this->actingAs($this->pengurus)
        ->deleteJson(route('kegiatan.media.destroy', [$this->kegiatan, $media->id]))
        ->assertNotFound();

    expect($media->fresh())->not->toBeNull();
});

Troubleshooting

Error / Gejala Penyebab Solusi
Thumbnail tidak pernah muncul Queue worker tidak memproses antrean media Jalankan worker dengan --queue=media,default; periksa failed_jobs
Call to undefined function imagecreatefromwebp / gagal konversi WebP Ekstensi GD tanpa dukungan WebP Pasang GD dengan WebP atau gunakan imagick
File has a mime type of ..., while only ... are allowed Tipe file tidak cocok dengan acceptsMimeTypes Sesuaikan daftar atau tolak lebih awal di validasi
File ... is too big Melebihi max_file_size media library Samakan dengan batas validasi, PHP, dan Nginx
Foto ponsel tampil miring Orientasi EXIF Pastikan ekstensi exif aktif; konversi menerapkan orientasi sebelum menyimpan
URL gambar 404 storage:link belum dibuat atau APP_URL salah php artisan storage:link, periksa APP_URL
Disk penuh file lama File yatim dari penghapusan manual media-library:clean; hapus media lewat model, bukan langsung di disk
N+1 query saat menampilkan daftar dengan gambar Media tidak di-eager load ->with('media')
Progres unggah tidak bergerak di tampilan Objek yang diubah bukan versi reaktif dari Alpine Ubah elemen yang diambil dari this.item, bukan objek asli sebelum di-push
Memori browser naik terus saat memilih banyak foto createObjectURL tidak dibebaskan Panggil URL.revokeObjectURL() setelah tidak dipakai

Best Practices

Keamanan

  • Validasi isi dan ekstensi file di server; validasi browser hanya kenyamanan.
  • Nama file dan path acak; jangan memakai nama dari pengguna di disk.
  • Verifikasi kepemilikan media pada setiap hapus/urutkan.
  • Dokumen sensitif di disk privat, disajikan lewat controller dengan Policy dan dicatat di activity log.
  • Tampilkan konversi (tanpa EXIF), bukan file asli, di halaman publik.

Performa

  • Konversi di queue (queue_conversions_by_default) agar unggah tetap cepat.
  • Gunakan WebP dan responsive images; thumbnail untuk daftar, ukuran sedang untuk detail.
  • loading="lazy" untuk gambar di bawah layar pertama.
  • Eager load relasi media.

Maintainability

  • Definisikan koleksi dan konversi di model, satu tempat untuk semua aturan media.
  • Satu komponen unggah Alpine untuk semua fitur yang membutuhkan galeri.
  • Jadwalkan media-library:clean, dan regenerasi konversi saat definisinya berubah.

Related Articles

Last Tested

Komponen Versi
Laravel 13.x
PHP 8.4
spatie/laravel-medialibrary 11.x
Alpine.js 3.x (+ @alpinejs/sort)
Pest 4.x
Tanggal 19 Oktober 2026

Bagikan artikel:

Artikel lainnya