Download the PHP package hifzi/wilayah-indonesia without Composer
On this page you can find all versions of the php package hifzi/wilayah-indonesia. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download hifzi/wilayah-indonesia
More information about hifzi/wilayah-indonesia
Files in hifzi/wilayah-indonesia
Package wilayah-indonesia
Short Description Package Laravel untuk data wilayah administratif Indonesia (Provinsi, Kabupaten/Kota, Kecamatan, Desa) lengkap dengan Kodepos. Super cepat dan ringan.
License MIT
Informations about the package wilayah-indonesia
Wilayah Indonesia
Package Laravel untuk data wilayah administratif Indonesia (Provinsi, Kabupaten/Kota, Kecamatan, Desa) lengkap dengan Kodepos. Super cepat, ringan, dan tidak membebani database.
Keunggulan Utama
- Zero Query (Nanodetik): Menggunakan sistem Caching Array murni di RAM, bebas dari overhead Eloquent Model. Setelah cache terbentuk, pemanggilan data terjadi dalam hitungan nanodetik.
- Dotless Code: Kode wilayah disimpan tanpa titik (contoh:
1101012001), memaksimalkan performa indexing database dan kecepatan pemotongan string (substr) di PHP. - Dynamic Table Prefix: Tabel bisa diawali
indonesia_,ref_, atau bebas sesuai konfigurasi.envtanpa merusak relasi. - Data Lengkap: Sudah termasuk data lebih dari 80.000 Desa/Kelurahan dan Kodepos seluruh Indonesia.
- Custom Artisan Command: Dilengkapi perintah khusus untuk seeding data secara instan.
Cocok Digunakan Untuk:
Package ini dirancang khusus untuk performa tinggi dan pengambilan data cepat. Sangat cocok digunakan untuk:
- Form Alamat Bertingkat: Dropdown / Select2 bertingkat (Provinsi -> Kota -> Kecamatan -> Desa) yang merespons sangat cepat.
- Autocomplete / Pencarian Kodepos: Fitur pencarian desa atau kodepos dengan response time cepat karena menggunakan Cache Array di RAM.
- Menampilkan Detail Alamat: Mengubah kode desa (contoh:
1101012001) menjadi alamat lengkap (Provinsi s/d Kodepos) tanpa melakukan queryJOINke database. - Microservice / API: Aplikasi yang membutuhkan response JSON ringan tanpa adanya overhead dari Eloquent Model.
Filosofi: Data Lengkap Tanpa Memaksa ORM (Model-Agnostic)
Package ini sengaja tidak menyertakan file Eloquent Model. Kami hanya menyediakan struktur tabel (Migrations) dan data lengkapnya (Seeders).
Kenapa ini menguntungkan?
- Nol Konflik: Tidak ada pemaksaan namespace Model (seperti
Hifzi\WilayahIndonesia\Models\Village). - Bebas Memilih: Anda bebas membuat Model sendiri di folder
app/Models/aplikasi Anda sesuai arsitektur bisnis Anda. - Zero Overhead: Untuk kebutuhan Form dan Autocomplete, gunakan Facade
IndRegyang menggunakan Cache Array murni. - Fleksibel untuk ORM: Jika Anda butuh fitur relasi Eloquent (
belongsTo,hasMany), cukup buat Model di aplikasi Anda yang mengarah ke tabel prefix yang Anda gunakan.
Contoh Membuat Model Sendiri di Aplikasi Anda:
Jika Anda butuh relasi ORM, buat Model di aplikasi Laravel Anda seperti ini:
Instalasi
-
Tambahkan package ke proyek Laravel Anda via Composer:
-
Publish Config & Migration:
-
Jalankan Migration:
-
Jalankan Seeder Data Wilayah:
(Opsional) Jika Anda ingin memasukkannya ke auto-seeder bawaan Laravel, tambahkan ini di
database/seeders/DatabaseSeeder.phpaplikasi Anda:
Konfigurasi (Opsional)
Anda bisa mengubah pengaturan di file config/wilayah-indonesia.php atau lewat file .env:
Penggunaan
Anda bisa menggunakan Facade IndReg di Controller Anda. (Anda juga bebas mengubah namanya menggunakan use ... as Wilayah; jika diinginkan).
1. Form Alamat Bertingkat (Select2 / Dropdown)
Untuk kebutuhan form alamat bertingkat (Provinsi -> Kota -> Kecamatan -> Desa). Data di-cache per level.
2. Dapatkan Alamat Lengkap dari Kode Desa
Sesuai untuk menampilkan detail alamat dari tabel companies atau users tanpa query JOIN.
3. Pencarian Desa (Autocomplete / Select2)
Mencari desa berdasarkan Nama Desa atau Kode Pos.
Fungsi ini digunakan untuk kebutuhan autocomplete/select2 pada form alamat. Hasil pencarian menampilkan informasi ringkas agar operator dapat memilih desa yang tepat ketika terdapat nama desa yang sama di wilayah berbeda.
Terimakasih Kepada
Data database wilayah dan kodepos yang digunakan pada package ini merupakan hasil kontribusi open-source dari:
All versions of wilayah-indonesia with dependencies
illuminate/support Version ^12.0 || ^13.0
illuminate/database Version ^12.0 || ^13.0