Download the PHP package fyyyn1210/kursbi without Composer
On this page you can find all versions of the php package fyyyn1210/kursbi. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download fyyyn1210/kursbi
More information about fyyyn1210/kursbi
Files in fyyyn1210/kursbi
Package kursbi
Short Description Paket pengambil kurs dari Bank Indonesia tanpa service provider untuk Laravel
License MIT
Homepage https://github.com/fyyyn1210/kursbi
Informations about the package kursbi
KursBI
Paket PHP untuk mengambil data kurs mata uang dari Bank Indonesia (BI) untuk PHP & Laravel.
📋 Deskripsi
KursBI adalah library PHP yang memudahkan pengambilan data kurs mata uang dari API resmi Bank Indonesia. Paket ini mendukung:
- ✅ Pengambilan kurs untuk satu atau beberapa mata uang sekaligus
- ✅ Penentuan rentang tanggal data kurs
- ✅ Pembatasan jumlah data hasil (limit)
- ✅ Konversi jumlah nominal berdasarkan kurs beli dan jual
- ✅ Caching data agar efisien dan mengurangi request berulang
- ✅ User-Agent dinamis untuk request yang lebih natural
- ✅ Support untuk Laravel Cache
🚀 Instalasi
Install via Composer:
💡 Penggunaan
Import Class
Inisialisasi
📖 Contoh Penggunaan
1. Mendapatkan Kurs USD Hari Ini
Return Value:
2. Mendapatkan Kurs Beberapa Mata Uang
Return Value:
3. Mendapatkan Kurs dengan Rentang Tanggal
Return Value:
4. Mendapatkan Kurs dengan Limit Data
Return Value:
5. Konversi Mata Uang dengan Jumlah Tertentu
Return Value:
6. Penggunaan Kompleks - Multiple Currency dengan Konversi
📚 API Reference
Method getKurs()
Parameters
| Parameter | Type | Default | Deskripsi |
|---|---|---|---|
$mataUang |
string |
'USD' |
Kode mata uang (bisa multiple, dipisah koma). Contoh: 'USD' atau 'USD,EUR,JPY' |
$startDate |
string\|null |
null |
Tanggal mulai (format: Y-m-d). Jika null, akan menggunakan tanggal hari ini |
$endDate |
string\|null |
null |
Tanggal akhir (format: Y-m-d). Jika null, akan menggunakan tanggal hari ini |
$limit |
int\|null |
null |
Batas jumlah data yang dikembalikan per mata uang |
$jumlah |
float\|null |
null |
Jumlah nominal untuk konversi mata uang |
Return Value
Method ini mengembalikan array dengan struktur:
⚙️ Fitur
Caching
Library ini menggunakan Laravel Cache untuk menyimpan hasil request selama 6 jam. Cache key menggunakan format: kursbi_{kode_mata_uang}_{start_date}_{end_date}.
User-Agent Dinamis
Setiap request menggunakan User-Agent yang digenerate secara random dari kombinasi OS dan browser populer untuk menghindari blocking.
Error Handling
Jika terjadi error saat mengambil data dari BI, method akan mengembalikan array kosong dan error akan di-report menggunakan fungsi report() Laravel.
🎯 Mata Uang yang Didukung
Library ini mendukung semua mata uang yang tersedia di API Bank Indonesia, termasuk namun tidak terbatas pada:
- USD (US Dollar)
- EUR (Euro)
- JPY (Japanese Yen)
- GBP (British Pound)
- SGD (Singapore Dollar)
- AUD (Australian Dollar)
- CHF (Swiss Franc)
- CAD (Canadian Dollar)
- HKD (Hong Kong Dollar)
- CNY (Chinese Yuan)
- Dan mata uang lainnya yang didukung BI
📋 Requirements
- PHP >= 7.4
- Laravel >= 8.0
- GuzzleHttp/Guzzle
- Laravel Cache
🤝 Contributing
Kontribusi selalu diterima! Silakan buat pull request atau buka issue untuk bug report dan feature request.
📄 License
Library ini menggunakan lisensi MIT. Lihat file LICENSE untuk detail lengkap.
🐛 Bug Reports
Jika Anda menemukan bug, silakan buat issue di GitHub Issues dengan informasi:
- Versi PHP yang digunakan
- Versi Laravel yang digunakan
- Code snippet yang menyebabkan error
- Pesan error yang muncul
📞 Support
Jika Anda butuh bantuan atau memiliki pertanyaan, silakan:
- Buka issue di GitHub
- Email: [[email protected]]
🎉 Credits
- Data kurs dari Bank Indonesia
- Terima kasih kepada semua kontributor
⭐ Jangan lupa berikan star jika library ini membantu Anda!
All versions of kursbi with dependencies
guzzlehttp/guzzle Version ^7.0
illuminate/support Version ^8.0|^9.0|^10.0