README

Paket Laravel yang fleksibel untuk mengintegrasikan layanan penyimpanan objek MinIO ke dalam aplikasi Laravel Anda. Paket ini membungkus fungsi MinIO menggunakan Laravel Filesystem (Flysystem AWS S3 v3 driver) sehingga memudahkan dalam menyimpan, mengambil, dan mengelola file.

📦 Instalasi

Pasang paket melalui composer:

composer require borwita-packages/php-minio-service

⚙ Konfigurasi

1. Atur .env

Tambahkan konfigurasi berikut di file .env:

FILESYSTEM_DISK=s3
AWS_ACCESS_KEY_ID=                // isi_dengan_user_minio_anda
AWS_SECRET_ACCESS_KEY=            // isi_dengan_password_minio_anda
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=                       // isi_dengan_bucket_minio_anda
AWS_ENDPOINT=                     // isi_dengan_endpoint_minio_anda
AWS_USE_PATH_STYLE_ENDPOINT=true

2. Atur endpoint bawaan untuk membuat pre-signed URL

Tambahkan konfigurasi berikut di file route/api.php:

...
use BorwitaPackages\MinioService\Http\Controllers\MinioController;
...
Route::post('/presigned-put-url', [MinioController::class, 'generatePutUrl'])->name('minio.presigned-put-url');
...

🚀 Contoh Penggunaan

Request Pre-signed URL (Menggunakan Route yang Dipublish)

Jika Anda telah membuat endpoint bawaan untuk membuat pre-signed URL.

1. Endpoint

POST /api/presigned-put-url

2. Contoh Request (cURL)

curl -i -X POST \
   -H "Content-Type:application/json" \
   -d '{
 "path": "uploads/Screenshot From 2025-07-15 14-37-22.png",
 "content_type": "image/png",
 "ttl": 1800
}' \
 'http://localhost:8000/api/presigned-put-url'

3. Contoh Response

{
  "url": {
    "url": "http://localhost:9000/ksp-gaskan-production/uploads/Screenshot%20From%202025-07-15%2014-37-22.png?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=minioadmin%2F20250813%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250813T093708Z&X-Amz-SignedHeaders=host&X-Amz-Expires=108000&X-Amz-Signature=e54569eda98baee03ab7d6e9958ea19d1a80b302e1706f33fd1d9d83213b9eba",
    "headers": {
      "Host": [
        "localhost:9000"
      ]
    }
  }
}

4. Menggunakan Pre-signed URL

curl -i -X PUT \
   -H "Content-Type:image/png" \
   -T "./Screenshot From 2025-07-15 14-37-22.png" \
 'http://localhost:9000/ksp-gaskan-production/uploads/Screenshot%20From%202025-07-15%2014-37-22.png?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=minioadmin%2F20250813%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250813T093708Z&X-Amz-SignedHeaders=host&X-Amz-Expires=108000&X-Amz-Signature=e54569eda98baee03ab7d6e9958ea19d1a80b302e1706f33fd1d9d83213b9eba'

Dengan ini, client dapat langsung upload file dari MinIO tanpa autentikasi tambahan.

Menggunakan Facade

use Minio;
// Presigned Url
Minio::putPresignedUrl('path/to/file.txt', 15, 'image/png');

// Upload file
Minio::put('path/to/file.txt', 'Isi file');

// Ambil isi file
$content = Minio::get('path/to/file.txt');

// Dapatkan URL file
$url = Minio::url('path/to/file.txt');

// Hapus file
Minio::delete('path/to/file.txt');

### Memilih Disk (Multi-Disk Support)

Anda dapat memilih disk yang berbeda (misalnya `s3-public`, `s3-private`) sesuai konfigurasi di `config/filesystems.php`.

// Menggunakan disk default ('s3') Minio::upload($path, $file);

// Menggunakan disk spesifik 's3-private' Minio::disk('s3-private')->upload($path, $file);

// Menggunakan disk spesifik 's3-public' Minio::disk('s3-public')->upload($path, $file);

🧑‍💻 Penulis

Nama: Miftach Noorvickia Mu'affaq Email: miftach.muaffaq@borwita.co.id Perusahaan: Borwita Group Lisensi: MIT License

📜 Lisensi

Paket ini adalah perangkat lunak open-source yang dilisensikan di bawah MIT license.