Download the PHP package silalahi/wilayah-php without Composer
On this page you can find all versions of the php package silalahi/wilayah-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Please rate this library. Is it a good library?
Informations about the package wilayah-php
Wilayah PHP Client
A PHP wrapper for the wilayah.id API, providing easy access to Indonesian administrative regions data including provinces, regencies/cities, districts, and villages.
Features
- 🎯 Clean, fluent API with separated resource classes
- 📦 PSR-4 autoloading compatible
- 🛡️ Exception handling
- 💡 Type hints for better IDE support
- 🔍 Search by name or code
- 🇮🇩 Multi-byte safe (supports Indonesian characters)
- 🚀 Supports PHP 7.4 and above
- 📝 Zero dependencies (except ext-json)
Installation
You can install this package via Composer:
Usage
Basic Usage
Response Format
All methods return an array with the following structure:
Working with Provinces
Working with Regencies
Working with Districts
Working with Villages
Fluent Chaining Example
Setting Timeout
API Reference
Client Methods
provinces(): Province- Get Province resourceregencies(): Regency- Get Regency resourcedistricts(): District- Get District resourcevillages(): Village- Get Village resourcesetTimeout(int $timeout): self- Set request timeout
Province Resource
all(): array- Get all provincesfind(string $code): ?array- Find province by codefindByName(string $name): ?array- Find province by namesearch(string $name): array- Search provinces by name pattern
Regency Resource
byProvince(string $provinceCode): array- Get regencies by provincefind(string $provinceCode, string $code): ?array- Find regency by codefindByName(string $provinceCode, string $name): ?array- Find regency by namefindByNameGlobal(string $name): ?array- Find regency across all provincessearch(string $provinceCode, string $name): array- Search regencies
District Resource
byRegency(string $regencyCode): array- Get districts by regencyfind(string $regencyCode, string $code): ?array- Find district by codefindByName(string $regencyCode, string $name): ?array- Find district by namesearch(string $regencyCode, string $name): array- Search districts
Village Resource
byDistrict(string $districtCode): array- Get villages by districtfind(string $districtCode, string $code): ?array- Find village by codefindByName(string $districtCode, string $name): ?array- Find village by namesearch(string $districtCode, string $name): array- Search villages
Error Handling
The library throws WilayahException when an error occurs. Always wrap your API calls in try-catch blocks:
Testing
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This package is open-sourced software licensed under the MIT license.
All versions of wilayah-php with dependencies
PHP Build Version
Package Version
Requires
php Version
^7.4 || ^8.0
ext-json Version *
ext-json Version *
The package silalahi/wilayah-php contains the following files
Loading the files please wait ...