PHPackages sagautam5/local-states-nepal - 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. [Utility & Helpers](/categories/utility) 4. / 5. sagautam5/local-states-nepal ActiveLibrary[Utility & Helpers](/categories/utility) sagautam5/local-states-nepal ============================ PHP Package for data set of local states of Nepal v2.1.0(1mo ago)334.7k30MITPHPPHP >=8.2CI passing Since Jan 4Pushed 1mo ago2 watchersCompare [ Source](https://github.com/sagautam5/local-states-nepal)[ Packagist](https://packagist.org/packages/sagautam5/local-states-nepal)[ RSS](/packages/sagautam5-local-states-nepal/feed)WikiDiscussions master Synced 2d ago READMEChangelog (10)Dependencies (4)Versions (14)Used By (0) Local States Nepal ================== [](#local-states-nepal) ##### This will help to get data about local states in Nepal based on recent administrative division [](#this-will-help-to-get-data-about-local-states-in-nepal-based-on-recent-administrative-division) [![Local States Nepal](images/latest-nepal.png)](images/latest-nepal.png) Image Source: [Wikipedia(Administrative divisions of Nepal)](https://simple.wikipedia.org/wiki/Administrative_divisions_of_Nepal) [![Build](https://github.com/sagautam5/local-states-nepal/workflows/CI/badge.svg)](https://github.com/sagautam5/local-states-nepal/workflows/CI/badge.svg)[![Latest Stable Version](https://camo.githubusercontent.com/ea36c0362c5c51ef371086cfb120805d859cc9b416d2a75898ecea9f4f7d433e/68747470733a2f2f706f7365722e707567782e6f72672f736167617574616d352f6c6f63616c2d7374617465732d6e6570616c2f76)](//packagist.org/packages/sagautam5/local-states-nepal)[![Total Downloads](https://camo.githubusercontent.com/357219ffa416ac02f842bdf7954259577a3e9acb00f81613732337170d490b99/68747470733a2f2f706f7365722e707567782e6f72672f736167617574616d352f6c6f63616c2d7374617465732d6e6570616c2f646f776e6c6f616473)](//packagist.org/packages/sagautam5/local-states-nepal)[![Issues](https://camo.githubusercontent.com/43123121c0edf1e1cd4a2f03a9ac52e52e4ca785b81800f41985c78746c25680/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f736167617574616d352f6c6f63616c2d7374617465732d6e6570616c)](https://github.com/sagautam5/local-states-nepal/issues) [![Stars](https://camo.githubusercontent.com/ee7062297b463e819fe4f9290b59042d61ee4d0807517656b47ceb089366e450/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f736167617574616d352f6c6f63616c2d7374617465732d6e6570616c)](https://github.com/sagautam5/local-states-nepal/stargazers)[![License](https://camo.githubusercontent.com/3930353191716ac5e86c6236da6a2f6e1322671338e6e72f07c70cbd12df2e33/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f736167617574616d352f6c6f63616c2d7374617465732d6e6570616c)](https://github.com/sagautam5/local-states-nepal/blob/master/LICENSE)[![Forks](https://camo.githubusercontent.com/2446f2622420052c74c5b3bd1d1e002df86e32739ca502e90ea8b3fe60fc9fee/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f736167617574616d352f6c6f63616c2d7374617465732d6e6570616c)](https://github.com/sagautam5/local-states-nepal/network/members)[![Twitter](https://camo.githubusercontent.com/fdcd5fb7f50cf46fbc34f410c8be9f208286463164ee271ff983930bfa7c8ef5/68747470733a2f2f696d672e736869656c64732e696f2f747769747465722f75726c3f75726c3d68747470732533412532462532466769746875622e636f6d253246736167617574616d352532466c6f63616c2d7374617465732d6e6570616c)](https://twitter.com/intent/tweet?text=Wow:&url=https%3A%2F%2Fgithub.com%2Fsagautam5%2Flocal-states-nepal) Description ----------- [](#description) Local States Nepal is the php composer package to get structured dataset about local states in Nepal. Local States Nepal requires PHP >= 7.0 Version **v1.0.8** has been tested on following php versions: - 7.0 - 7.1 - 7.2 - 7.3 - 7.4 Version **v2.0.0** has been tested on following php versions: - 8.0 - 8.1 - 8.2 - 8.3 Version **v2.0.1** has been tested on following php versions: - 8.4 Version **v2.1.0** has been tested on following php versions: - 8.5 Demo ---- [](#demo) You can view Province -> District -> Municipality -> Wards in following demo. ### How to set up demo ? [](#how-to-set-up-demo-) You can find all source code for demo inside demo directory. You can clone this repository in your server and then visit following url: `local_server_url/local-states-nepal/demo/` Example: [![Laravel Nepal](demo/assets/images/demo-page-latest.png)](demo/assets/images/demo-page-latest.png) Demo Video: Additionally, you can setup with Docker and visit [localstates.test](http://localstates.test) to view the demo. Here is guideline for setting up with Docker. [Local setup with Docker](./docs/docker/setup.md) Support ------- [](#support) Currently, This library supports following two languages. - English - नेपाली Installation ------------ [](#installation) ``` composer require sagautam5/local-states-nepal ``` Configuration ------------- [](#configuration) Currently, No mandatory configuration is required for using this package. We have used english as the default language and if you want nepali you have to specify the language while using this package. About Dataset ------------- [](#about-dataset) All data are collected from wikipedia and various Nepal government sites. We have data set in Nepali and English format for following four entities. 1. [Province](./docs/dataset/Province.md) 2. [District](./docs/dataset/District.md) 3. [Municipality](./docs/dataset/Municipality.md) 4. [Category](./docs/dataset/Category.md) 5. [Nested Data Set](./docs/dataset/NestedData.md) You can see more details about data in the link provided in above list. Basic Usage ----------- [](#basic-usage) After installation, you can use features like this: ``` use Sagautam5\LocalStateNepal\Entities\Province; $province = new Province('np'); // Get List of all Provinces $provincesData = $province->allProvinces(); // Get List of All Provinces with District $provincesData = $province->getProvincesWithDistricts(); // Get List of All Provinces with District and Districts with Municipalities $provincesData = $province->getProvincesWithDistrictsWithMunicipalities(); ``` NOTE: Default language is 'en' and if you want 'np' then you have to specify language while creating class object. You can see more detail documentation of each entity in the links provided in following list. 1. [Provinces](./docs/usage/Province.md) 2. [Districts](./docs/usage/District.md) 3. [Municipality](./docs/usage/Municipality.md) 4. [Category](./docs/usage/Category.md) Security -------- [](#security) If you discover a security vulnerability within this package, please send an e-mail to , All security vulnerabilities will be promptly addressed. 🤝 Contributing -------------- [](#-contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. 📄 License --------- [](#-license) The MIT License (MIT). Please see [License File](LICENSE) for more information. ### Health Score 58 — FairBetter than 98% of packages Maintenance90 Actively maintained with recent releases Popularity36 Limited adoption so far Community19 Small or concentrated contributor base Maturity73 Established project with proven stability Bus Factor1 Top contributor holds 95.1% 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 ~158 days Recently: every ~273 days Total 13 Last Release 52d ago Major Versions v1.0.8 → v2.0.02024-04-28 PHP version history (2 changes)v2.0.0PHP >=8.0 v2.0.1PHP >=8.2 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/10434281?v=4)[Sagar Gautam](/maintainers/sagautam5)[@sagautam5](https://github.com/sagautam5) --- Top Contributors [![sagautam5](https://avatars.githubusercontent.com/u/10434281?v=4)](https://github.com/sagautam5 "sagautam5 (155 commits)")[![iamsubingyawali](https://avatars.githubusercontent.com/u/45819206?v=4)](https://github.com/iamsubingyawali "iamsubingyawali (3 commits)")[![kamalakhatiwada](https://avatars.githubusercontent.com/u/32019574?v=4)](https://github.com/kamalakhatiwada "kamalakhatiwada (2 commits)")[![AsmitNepali](https://avatars.githubusercontent.com/u/33512152?v=4)](https://github.com/AsmitNepali "AsmitNepali (1 commits)")[![Prabesh01](https://avatars.githubusercontent.com/u/51240439?v=4)](https://github.com/Prabesh01 "Prabesh01 (1 commits)")[![santosh-exe](https://avatars.githubusercontent.com/u/96971356?v=4)](https://github.com/santosh-exe "santosh-exe (1 commits)") --- Tags composer-packagedatasetlocal-states-nepalphp ### Code Quality TestsPest Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/sagautam5-local-states-nepal/health.svg) ``` [![Health](https://phpackages.com/badges/sagautam5-local-states-nepal/health.svg)](https://phpackages.com/packages/sagautam5-local-states-nepal) ``` ### Alternatives [hyperf/socketio-server Socket.io implementation for hyperf 25130.9k6](/packages/hyperf-socketio-server)[gonetone/laravel-boost-windsurf-extension Laravel Boost extension package that provides Windsurf editor and Windsurf JetBrains plugin integration. 239.1k](/packages/gonetone-laravel-boost-windsurf-extension)[adereldo/correios Consulta de cep,rastreio em site do correios 121.4k](/packages/adereldo-correios) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)