README

📌 Pendahuluan

Laravel Image Compressor adalah package Laravel yang berfungsi untuk mengompres gambar sebelum disimpan. Package ini akan secara otomatis menggunakan Imagick jika tersedia, atau fallback ke GD jika Imagick tidak ditemukan.

⚡ Untuk hasil kompresi yang lebih optimal, disarankan untuk mengaktifkan Imagick di PHP. Imagick memiliki algoritma kompresi yang lebih efisien dibandingkan GD, sehingga dapat menghasilkan ukuran file yang lebih kecil dengan kualitas yang lebih baik. Namun, jika Imagick tidak tersedia, package ini akan otomatis menggunakan GD sebagai alternatif.

🛠 Instalasi

1. Install melalui Composer

composer require v-pack/laravel-image-compressor

2. Publish Konfigurasi (Opsional)

php artisan vendor:publish --provider="VPACK\ImageCompressor\ImageCompressorServiceProvider"

🚀 Penggunaan di Laravel

Gunakan di controller sebelum menyimpan gambar:

use VPACK\ImageCompressor\ImageCompressor;
use Illuminate\Http\UploadedFile;

private function uploadGetPayload(array $payload)
{
    if (!empty($payload['photo']) && $payload['photo'] instanceof UploadedFile) {
        $fileName = $this->generateFileName($payload['photo'], 'USER_' . date('Ymdhis'));

        // 🔹 Ambil path asli dari file sementara Laravel
        $tempPath = $payload['photo']->getPathname();

        // 🔹 Kompres gambar sebelum disimpan
        ImageCompressor::compress($tempPath, 70);

        // 🔹 Simpan gambar ke storage
        $photo = $payload['photo']->storeAs(self::USER_PHOTO_DIRECTORY, $fileName, 'public');

        $payload['photo'] = $photo;
    } else {
        unset($payload['photo']);
    }

    return $payload;
}

🎯 Fitur

✔ Kompresi otomatis sebelum menyimpan gambar. ✔ Menggunakan Imagick atau GD sesuai dengan ketersediaan. ✔ Mudah dipakai dalam controller Laravel. ✔ Ringan dan efisien dalam penggunaan sumber daya. ✔ Dukungan berbagai format gambar seperti JPEG dan PNG. ✔ Konfigurasi kualitas kompresi yang fleksibel.

📝 Lisensi

Package ini dirilis di bawah lisensi MIT, yang berarti Anda bebas menggunakannya dan memodifikasinya sesuai kebutuhan proyek Anda.

🚀 Laravel Image Compressor siap membantu mengoptimalkan penyimpanan gambar di proyek Laravel Anda!