Download the PHP package devaspid/safi-laravel-client without Composer
On this page you can find all versions of the php package devaspid/safi-laravel-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package safi-laravel-client
SAFI Laravel Client SDK
Laravel Client SDK resmi untuk terhubung dengan server SAFI by devASPid (https://safi.asp.web.id). Package ini mempermudah integrasi, agregasi, serta pengiriman data transaksi secara aman dan terstruktur.
๐ Fitur Utama
- โก Dua Mode Integrasi Flexible:
- Pull Mode (Rekomendasi): Server SAFI yang menarik data transaksi & cabang secara terjadwal dari aplikasi Anda.
- Push Mode: Aplikasi Anda yang mengirim data transaksi (real-time atau background queue job) ke server SAFI.
- ๐ Auto-Retry & Fault Tolerance: Proteksi otomatis saat koneksi jaringan tidak stabil dengan graceful error handling.
- ๐ Hourly & RFM Aggregator Helper: Mengelompokkan transaksi lokal secara otomatis per jam (0โ23), per cabang, serta analisis RFM pelanggan.
- ๐คน Multi-Platform Support: Siap digunakan untuk Retail POS, E-Commerce, dan Crowdfunding.
- ๐งช Compatibility: Mendukung PHP 8.0 s/d 8.4+ dan Laravel 9.0 s/d 13.0+.
๐ฆ Persyaratan Sistem
| Komponen | Versi yang Didukung |
|---|---|
| PHP Runtime | ^8.0 | ^8.1 | ^8.2 | ^8.3 | ^8.4 |
| Laravel Framework | ^9.0 | ^10.0 | ^11.0 | ^12.0 | ^13.0 |
๐ Instalasi
Jalankan perintah Composer berikut di terminal proyek Laravel Anda:
Publish file konfigurasi safi.php ke proyek Anda:
โ๏ธ Konfigurasi .env
Tambahkan variabel lingkungan berikut di file .env aplikasi Anda:
๐ป Panduan Penggunaan & Integrasi
SAFI mendukung dua mode integrasi. Anda bisa memilih salah satu atau menggabungkan keduanya sesuai kebutuhan.
๐ข MODE 1: PULL PROVIDER (Rekomendasi Utama)
Dalam mode ini, server SAFI Hub (https://safi.asp.web.id) yang akan melakukan request GET secara berkala ke aplikasi Anda untuk mengambil data transaksi atau daftar cabang.
1. Endpoint Transaksi Agregat (GET /api/safi/sync)
Daftarkan route di routes/api.php:
Buat controller app/Http/Controllers/Api/SafiSyncExportController.php:
Catatan:
Safi::pullResponder()secara otomatis menangani:
- Verifikasi header
X-API-KEY.- Penarikan seluruh cabang aktif saat tidak ada filter cabang.
- Penarikan data khusus satu cabang saat parameter
?branch_code=...disertakan oleh SAFI Hub.- Komputasi
daily_summarydanhourly_summaryper cabang secara instan. bashSinkronisasi data per jam
php artisan safi:sync-hourly
Sinkronisasi / rekap data harian
php artisan safi:sync-daily bash composer test bash composer test-coverage
---
## ๐ Lisensi
Package ini berlisensi open-source di bawah [MIT License](LICENSE.md).All versions of safi-laravel-client with dependencies
guzzlehttp/guzzle Version ^7.2
illuminate/contracts Version ^9.0 || ^10.0 || ^11.0 || ^12.0 || ^13.0
illuminate/http Version ^9.0 || ^10.0 || ^11.0 || ^12.0 || ^13.0
illuminate/support Version ^9.0 || ^10.0 || ^11.0 || ^12.0 || ^13.0