denason/iran-location
A Laravel package to manage Iranian location data including provinces and cities,and Eloquent relations,helpers,facades and Caching features
1,428
3
| Install | |
|---|---|
composer require denason/iran-location |
|
| Latest Version: | v1.1.4 |
| PHP: | >=8.0 |
| Laravel: | 9 – 12 |
| License: | MIT |
| Last Updated: | Apr 21, 2025 |
| Links: | GitHub · Packagist |
Maintainer: DenaSon
🇮🇷 Iran Locations for Laravel
🌾 اطلاعات موقعیت مکانی ایران (استان‌ها و شهرها)
🌾 اطلاعات موقعیت مکانی ایران (استان‌ها و شهرها)
این پکیج لاراول، لیست کامل استان‌های ایران و شهرهای وابسته به هر استان را فراهم می‌کند.
A professional and extendable Laravel package for accessing all Iranian provinces and their cities.
✨ ویژگی‌ها
- 🌍 لیست کامل استان‌ها و شهرهای ایران
- 🔗 رابطه‌ی یک‌به‌چند بین استان‌ها و شهرها
- ⚡ فراخوانی ساده از طریق Facade و Helper
- 🔎 قابلیت دریافت شهرها براساس ID یا نام استان
- 🌐 پشتیبانی از نام فارسی (و در آینده: انگلیسی)
- 🧰 مناسب برای پروژه‌های فرم‌محور
- ⚙️ کشینگ برای افزایش سرعت و کارایی
📦 نصب پکیج
composer require denason/iran-location
⚙️ مراحل نصب و راه‌اندازی
php artisan iran-location:install
- اجرای مایگریشن‌ها
- اجرای Seeder برای استان‌ها و شهرها
🚀 استفاده از پکیج
Facade:
use Denason\IranLocation\Facades\IranLocation;
$provinces = IranLocation::getProvinces();
Helper:
$provinces = iranLocation()->getProvinces();
$cities = iranLocation()->getCitiesByProvinceId(1);
⚖️ متدهای قابل استفاده
| Method | Description |
|---|---|
getProvinces() |
دریافت تمام استان‌ها |
getProvinceById($id) |
دریافت استان بر اساس ID |
getProvinceByName($name) |
دریافت استان بر اساس نام |
getCities() |
دریافت تمام شهرها |
getCitiesByProvinceId($provinceId) |
دریافت شهرهای یک استان بر اساس ID |
getCitiesByProvinceName($provinceName) |
دریافت شهرهای یک استان بر اساس نام |
getCityById($id) |
دریافت یک شهر خاص بر اساس ID |
getCityByName($name) |
دریافت یک شهر خاص بر اساس نام |
getProvincesWithCities() |
دریافت همه استان‌ها همراه با لیست شهرها |
getProvinceOfCityId($cityId) |
دریافت استان مربوط به یک شهر بر اساس ID |
getProvinceOfCityName($cityName) |
دریافت استان مربوط به یک شهر بر اساس نام |
Related Packages
shimadotdev/iran-regions
A Laravel package containing province and city data of Iran, including calling c...
46
16
alexpechkarev/google-geocoder
Simple Google Geocoding API v3 wrapper for Laravel 4/5, Slim3 etc
416,335
74
fhusquinet/laravel-google-geocoding
Easy to use API to retrieve geocoding results from Google in your Laravel applic...
3,495
2
Version History
| Version | Released | PHP | Laravel | License |
|---|---|---|---|---|
| v1.1.4 | >=8.0 | ^9.0| | MIT | |
| v1.1.3 | >=8.0 | ^9.0| | MIT | |
| v1.1.2 | >=8.0 | ^9.0| | MIT | |
| v1.1.1 | >=8.0 | ^9.0| | MIT | |
| v1.1.0 | >=8.0 | ^9.0| | MIT |