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=minioadmin
AWS_SECRET_ACCESS_KEY=minioadmin
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=ksp-gaskan-production
AWS_ENDPOINT=http://localhost:9000
AWS_USE_PATH_STYLE_ENDPOINT=true

2. Atur Variabel Lingkungan

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');
...

🚀 Penggunaan

Request Pre-signed URL (Menggunakan Route yang Dipublish)

Jika Anda telah mem-publish routes/api.php dari paket ini, maka Anda sudah memiliki 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 mengunduh file dari MinIO tanpa autentikasi tambahan.

Menggunakan Facade

use Minio;

// 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');

🧑‍💻 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.

borwita-packages / php-minio-service

Maintainers

Details