Download the PHP package zhiephie/lushi without Composer
On this page you can find all versions of the php package zhiephie/lushi. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package lushi
Laravel Lushi 📜
Lushi is a library of static Eloquent models for fixture data Administrative Subdivisions of Indonesia, such as provincies, regencies, districts and villages.
Contents
- Installing Lushi
- Using a model
- Available models
Lushi\Models\Province
Lushi\Models\Regency
Lushi\Models\District
Lushi\Models\Village
- Model relationships
- Column customisation
- Contributing
Installing Lushi
You can use Composer to install Lushi into your application.
No additional setup is required.
Using a model
You can interact with a Lushi model just like you would any other Eloquent model, except that it only handles read-only operations.
Available models
Lushi\Models\Province
Column Name | Description | Example |
---|---|---|
id |
ID province. | 11 |
name |
Province name. | Jawa Timur |
Relationship name | Model |
---|---|
regencies |
Lushi\Models\Regency |
Lushi\Models\Regency
Column Name | Description | Example |
---|---|---|
id |
ID regency. | 1101 |
province_id |
ID province. | 11 |
name |
Regency name. | KOTA SABANG |
Relationship name | Model |
---|---|
districts |
Lushi\Models\District |
Lushi\Models\District
Column Name | Description | Example |
---|---|---|
id |
ID District. | 1101010 |
regency_id |
ID regency. | 1101 |
name |
District name. | TEUPAH SELATAN |
Relationship name | Model |
---|---|
villages |
Lushi\Models\Village |
Model relationships
Implementing an Eloquent relationship between a model in your app and a Lushi model is very simple. There are a couple of approaches you could take.
Using inheritance
The simplest option is to create a new model in your app, and let it extend the Lushi model. Your new app model will now behave like the original Lushi model, except you can register new methods and customise it to your liking:
See our section on model customisation for more customisation possibilities that are made available if you utilise this method.
Column customisation
Lushi allows you to customise the column names on any provided model.
Create a new model within your app and let it extend the Lushi model that you would like to customise:
In this example, the App\Models\Province
, extending the Lushi\Models\Province
model, has the province_code
column remapped to id
:
Contributing
If you have fixture data to contribute to the library, please open a pull request!
For reference, check out the existing models.