PHPackages salibhdr/typhoon-iran-cities - 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. [Database & ORM](/categories/database) 4. / 5. salibhdr/typhoon-iran-cities ActiveLibrary[Database & ORM](/categories/database) salibhdr/typhoon-iran-cities ============================ A laravel package for importing all regions such as provinces, counties, cities, city districts, rural districts and villages of iran into database accurately 4.0.0(1mo ago)6322.2k↓61.1%4MITPHPPHP ^8.3CI passing Since Feb 29Pushed 1mo ago1 watchersCompare [ Source](https://github.com/SaliBhdr/typhoon-iran-cities)[ Packagist](https://packagist.org/packages/salibhdr/typhoon-iran-cities)[ RSS](/packages/salibhdr-typhoon-iran-cities/feed)WikiDiscussions master Synced 2w ago READMEChangelog (10)Dependencies (7)Versions (15)Used By (0) Typhoon Iran Cities =================== [](#typhoon-iran-cities) [![SaliBhdr|typhoon](https://camo.githubusercontent.com/888a4d4c2e3a42fed2e33f3d3c1e18d93285fb88031ceba881ac9b98f5b06754/68747470733a2f2f64726976652e676f6f676c652e636f6d2f612f646f6d61696e2e636f6d2f7468756d626e61696c3f69643d3132796e744643695949474a7a4939464d55614639635274584b62307258683958)](https://camo.githubusercontent.com/888a4d4c2e3a42fed2e33f3d3c1e18d93285fb88031ceba881ac9b98f5b06754/68747470733a2f2f64726976652e676f6f676c652e636f6d2f612f646f6d61696e2e636f6d2f7468756d626e61696c3f69643d3132796e744643695949474a7a4939464d55614639635274584b62307258683958) [![Tests](https://github.com/SaliBhdr/typhoon-iran-cities/actions/workflows/tests.yml/badge.svg)](https://github.com/SaliBhdr/typhoon-iran-cities/actions/workflows/tests.yml)[![Coverage](https://camo.githubusercontent.com/e0e5011644f657fc09afee67dc389c4bea0b8c824fee1dbe6ef468cb22f929bb/68747470733a2f2f636f6465636f762e696f2f67682f53616c69426864722f747970686f6f6e2d6972616e2d6369746965732f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/SaliBhdr/typhoon-iran-cities)[![Total Downloads](https://camo.githubusercontent.com/1438c67a6908861f76184d32ef0522ba52f864cc6f7b38a293decd7c09241cdb/68747470733a2f2f706f7365722e707567782e6f72672f73616c69626864722f747970686f6f6e2d6972616e2d6369746965732f646f776e6c6f616473)](https://packagist.org/packages/salibhdr/typhoon-iran-cities/stats)[![Required Laravel Version](https://camo.githubusercontent.com/b57ace4b9333dabe64d09160a0b69a297d911a705ad12b7ebd5ea08bdd617dd6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d25354531332e302d6666326432303f7374796c653d666c61742d737175617265266c6f676f3d6c61726176656c)](https://packagist.org/packages/salibhdr/typhoon-iran-cities)[![Required PHP Version](https://camo.githubusercontent.com/fdd9c2ef1709e3183268ef2974ac5a89a7f92a76721c2b411de778aa5b484a70/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e332d3838393262663f7374796c653d666c61742d737175617265266c6f676f3d706870)](https://packagist.org/packages/salibhdr/typhoon-iran-cities)[![Latest Version](https://camo.githubusercontent.com/19c68ff184920971cc9bd69bb07d121a7f3ae916def4f5d8cf734e919bd30cea/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73616c69626864722f747970686f6f6e2d6972616e2d6369746965732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/salibhdr/typhoon-iran-cities)[![License](https://camo.githubusercontent.com/a3819e9a5c26a1de206b6447a04f46d17793c06797602d82c8a62c186471fcfa/68747470733a2f2f706f7365722e707567782e6f72672f73616c69626864722f747970686f6f6e2d6972616e2d6369746965732f762f756e737461626c65)](https://packagist.org/packages/salibhdr/typhoon-iran-cities)[![Today Downloads](https://camo.githubusercontent.com/201fe83736b0760b1dadd44df0c19e4cb76f6d216d4fb2c5dc997e8b36fe00f4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64642f73616c69626864722f747970686f6f6e2d6972616e2d6369746965732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/salibhdr/typhoon-iran-cities/stats) **English** · **[فارسی](./docs/fa/README.md)** A Laravel package that imports Iran's administrative divisions — provinces, counties, sectors, cities, city districts, rural districts, and villages — into your database with Artisan commands. Includes Eloquent models, relationships, and optional city coordinates. ``` composer require salibhdr/typhoon-iran-cities php artisan iran:init --no-interaction --force ``` Requires **Laravel 13** and **PHP 8.3+** on the latest release. Older Laravel apps should use [`^3.1`](./docs/en/requirements-and-versioning.md) — see the [version matrix](./docs/en/requirements-and-versioning.md). [![Administrative divisions of Iran](./docs/images/administrative_divisions_of_Iran.jpg)](./docs/images/administrative_divisions_of_Iran.jpg) --- Documentation ------------- [](#documentation) Full documentation lives in [`docs/`](./docs/README.md) — available in **English** and **Persian (فارسی)**. Englishفارسی**Start here**[English docs](./docs/en/README.md)[مستندات فارسی](./docs/fa/README.md)**Hub / TOC**[docs/README.md](./docs/README.md)same### Table of contents [](#table-of-contents) TopicENFAIntroduction[→](./docs/en/introduction.md)[→](./docs/fa/introduction.md)Requirements & versioning[→](./docs/en/requirements-and-versioning.md)[→](./docs/fa/requirements-and-versioning.md)Installation[→](./docs/en/installation.md)[→](./docs/fa/installation.md)Quick start[→](./docs/en/quick-start.md)[→](./docs/fa/quick-start.md)Storage modes (separate / unite)[→](./docs/en/storage-modes.md)[→](./docs/fa/storage-modes.md)Commands reference[→](./docs/en/commands-reference.md)[→](./docs/fa/commands-reference.md)Models & relationships[→](./docs/en/models-and-relationships.md)[→](./docs/fa/models-and-relationships.md)Status field[→](./docs/en/status-field.md)[→](./docs/fa/status-field.md)City coordinates[→](./docs/en/city-coordinates.md)[→](./docs/fa/city-coordinates.md)Upgrade guide[→](./docs/en/upgrade-guide.md)[→](./docs/fa/upgrade-guide.md)FAQ & troubleshooting[→](./docs/en/faq-and-troubleshooting.md)[→](./docs/fa/faq-and-troubleshooting.md)Testing & contributing[→](./docs/en/testing-and-contributing.md)[→](./docs/fa/testing-and-contributing.md)--- Features at a glance -------------------- [](#features-at-a-glance) - All seven official division levels with relational data and codes - **Separate tables** (default) or **unite mode** (single `iran_regions` table) - Selective import with `--target` (e.g. cities only) - Published migrations and models — you own the schema - Active/inactive `status` with hierarchy-aware scopes - City latitude/longitude via `--with-city-coordinates` - Re-import with `--fresh` when upstream data updates --- Quick example ------------- [](#quick-example) ``` use App\Models\IranCity; IranCity::active() ->with('county.province') ->orderBy('name') ->get(); ``` --- Testing ------- [](#testing) ``` composer test composer test:coverage # requires PCOV ``` Coverage runs in CI on every push and PR — [Codecov](https://codecov.io/gh/SaliBhdr/typhoon-iran-cities). --- Package dependency ------------------ [](#package-dependency) Published **models** extend `SaliBhdr\TyphoonIranCities\Models\*` — **keep this package installed** after `iran:publish:models`. Published **migrations** are self-contained and do not reference the package namespace. --- Changelog & upgrades ------------------------ [](#changelog--upgrades) See [CHANGELOG.md](./CHANGELOG.md) and the [upgrade guide (EN)](./docs/en/upgrade-guide.md) / [راهنمای ارتقا (FA)](./docs/fa/upgrade-guide.md). --- License & credits --------------------- [](#license--credits) MIT License — [Salar Bahador](https://github.com/salibhdr/typhoon-iran-cities). Data based on [ahmadazizi/iran-cities](https://github.com/ahmadazizi/iran-cities) v3. Issues: [GitHub](https://github.com/salibhdr/typhoon-iran-cities/issues) · Contributions welcome. Built with ❤ for you. ### Health Score 60 — FairBetter than 98% of packages Maintenance90 Actively maintained with recent releases Popularity39 Limited adoption so far Community14 Small or concentrated contributor base Maturity80 Battle-tested with a long release history Bus Factor1 Top contributor holds 92.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 ~193 days Recently: every ~451 days Total 13 Last Release 47d ago Major Versions 1.3.1 → 2.0.02021-07-10 2.1.5 → 3.0.02021-08-30 3.1.0 → 4.0.02026-07-02 PHP version history (2 changes)1.0.0-stablePHP >=5.6.0 4.0.0PHP ^8.3 ### Community Maintainers ![](https://www.gravatar.com/avatar/354ba6970d05ad127ba1fb0c1e8a13ed38b8da3189551dbd192680e6699b57eb?d=identicon)[bahador.salar](/maintainers/bahador.salar) --- Top Contributors [![SaliBhdr](https://avatars.githubusercontent.com/u/27485366?v=4)](https://github.com/SaliBhdr "SaliBhdr (93 commits)")[![soullessthread](https://avatars.githubusercontent.com/u/79604066?v=4)](https://github.com/soullessthread "soullessthread (6 commits)")[![ariaieboy](https://avatars.githubusercontent.com/u/15873972?v=4)](https://github.com/ariaieboy "ariaieboy (1 commits)")[![salar-bahador](https://avatars.githubusercontent.com/u/180277912?v=4)](https://github.com/salar-bahador "salar-bahador (1 commits)") --- Tags citiescountiesiraniran-citiesiran-countiesiran-provinceslaravellaravel-iran-citiesphpprovincestyphoon-iran-citiesvillageslaravelcityprovinceiranregionslocationscountyvillagesalibhdrcity-districtrural-district ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/salibhdr-typhoon-iran-cities/health.svg) ``` [![Health](https://phpackages.com/badges/salibhdr-typhoon-iran-cities/health.svg)](https://phpackages.com/packages/salibhdr-typhoon-iran-cities) ``` ### Alternatives [laravel/ai The official AI SDK for Laravel. 1.1k4.6M322](/packages/laravel-ai)[illuminate/queue The Illuminate Queue package. 20433.0M1.8k](/packages/illuminate-queue)[spatie/laravel-medialibrary Associate files with Eloquent models 6.2k45.4M705](/packages/spatie-laravel-medialibrary)[api-platform/laravel API Platform support for Laravel 58190.1k21](/packages/api-platform-laravel)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 265.2k](/packages/aedart-athenaeum)[forjedio/inertia-table Backend-driven dynamic tables for Laravel + Inertia.js 272.0k](/packages/forjedio-inertia-table) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)