PHPackages                             snairbef/regional - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. snairbef/regional

ActiveLibrary

snairbef/regional
=================

This is my package regional

v2.0.0(1mo ago)184↑215.8%MITPHPPHP ^8.2|^8.3|^8.4CI passing

Since Jan 8Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/febryars33/regional)[ Packagist](https://packagist.org/packages/snairbef/regional)[ Docs](https://github.com/febryars33/regional)[ GitHub Sponsors](https://github.com/Snairbef)[ RSS](/packages/snairbef-regional/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (12)Versions (8)Used By (0)

Indonesian Regional
===================

[](#indonesian-regional)

[![Latest Version on Packagist](https://camo.githubusercontent.com/5c946145211079e4c385a7284de8a5446886ad4e25a18d4960102ff3117cddbb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736e6169726265662f726567696f6e616c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/snairbef/regional)[![GitHub Tests Action Status](https://camo.githubusercontent.com/d08a621961ffd45bc4cd9ee034d1044190cc957e2ca83ce9590c7a1ab6c9176a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f666562727961727333332f726567696f6e616c2f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/snairbef/regional/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/e919a4dc02fe061e30a91fb8b9a090103858f4aa9523061d0217dbf8da086d24/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f666562727961727333332f726567696f6e616c2f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/snairbef/regional/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/2bab69cb48cc65b15d557ac0e8245eb4c33d68cd9980e40e49d1fe4a1d8c8460/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f736e6169726265662f726567696f6e616c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/snairbef/regional)

Indonesian Regional Dependency adalah package Laravel yang dirancang untuk mempermudah pengelolaan data wilayah Indonesia, seperti provinsi, kabupaten/kota, kecamatan, hingga kelurahan. Package ini menyediakan model siap pakai, relasi bawaan, serta fungsi untuk mengimpor data wilayah ke dalam database Anda menggunakan file CSV yang disertakan (provinces.csv, regencies.csv, districts.csv, sub\_districts.csv).

Penggunaannya sederhana dan intuitif, menyerupai penggunaan model bawaan Laravel. Anda cukup memanggil model seperti `Snairbef\Regional\Models\Province` atau `Snairbef\Regional\Models\Regency`, lengkap dengan dukungan untuk Repository Pattern melalui interface yang dapat langsung diinject ke dalam controller Anda.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require snairbef/regional
```

Now you can install the package to Laravel Project:

```
php artisan regional:install
```

You can run the migrations with:

```
php artisan migrate
```

You can import data from the csv that we have provided:

```
php artisan regional:import
```

Usage (Model)
-------------

[](#usage-model)

```
use Snairbef\Regional\Models\Province;

$province = Province::with(['regencies']);
dd($province->get());

or

$province = Province::search('Jawa');
dd($province);
```

Usage (Repository)
------------------

[](#usage-repository)

```
use Illuminate\Routing\Controller;
use Snairbef\Regional\Contracts\Repositories\ProvinceRepository;

class YourController extends Controller
{
    public function __construct(
        protected ProvinceRepository $province
    ) {}

    public function index()
    {
        $province = $this->province->with(['regencies']);
        dd($province->get());

        or

        $province = $this->province->search('Jawa');
        dd($province);
    }
}
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Febriansyah Riki Setiadi](https://github.com/febryars33)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

48

—

FairBetter than 94% of packages

Maintenance96

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~87 days

Total

6

Last Release

50d ago

Major Versions

v1.3.1 → 11.x-dev2026-03-20

PHP version history (2 changes)v1.1.0PHP ^8.4||^8.3

v2.0.0PHP ^8.2|^8.3|^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/8fb8fb96d98952602cfdcd5943907c1ad647c4e96b2b202564c0d13e403a2d91?d=identicon)[febryars33](/maintainers/febryars33)

---

Top Contributors

[![febryars33](https://avatars.githubusercontent.com/u/48888849?v=4)](https://github.com/febryars33 "febryars33 (51 commits)")

---

Tags

laravelregionalSnairbef

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/snairbef-regional/health.svg)

```
[![Health](https://phpackages.com/badges/snairbef-regional/health.svg)](https://phpackages.com/packages/snairbef-regional)
```

###  Alternatives

[vormkracht10/laravel-mails

Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app.

24149.7k](/packages/vormkracht10-laravel-mails)[spatie/laravel-prometheus

Export Laravel metrics to Prometheus

2651.3M6](/packages/spatie-laravel-prometheus)[hydrat/filament-table-layout-toggle

Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts.

6292.3k1](/packages/hydrat-filament-table-layout-toggle)[scalar/laravel

Render your OpenAPI-based API reference

6183.9k2](/packages/scalar-laravel)[ralphjsmit/laravel-helpers

A package containing handy helpers for your Laravel-application.

13704.6k2](/packages/ralphjsmit-laravel-helpers)[musahmusah/laravel-multipayment-gateways

A Laravel Package that makes implementation of multiple payment Gateways endpoints and webhooks seamless

852.2k1](/packages/musahmusah-laravel-multipayment-gateways)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
