承接 denason/iran-location 相关项目开发

从需求分析到上线部署,全程专人跟进,保证项目质量与交付效率

邮箱:yvsm@zunyunkeji.com | QQ:316430983 | 微信:yvsm316

denason/iran-location

最新稳定版本:v1.1.4

Composer 安装命令:

composer require denason/iran-location

包简介

A Laravel package to manage Iranian location data including provinces and cities,and Eloquent relations,helpers,facades and Caching features

README 文档

README

🌾 اطلاعات موقعیت مکانی ایران (استان‌ها و شهرها)

Latest Version on Packagist License: MIT Laravel Tests Total Downloads

🌾 اطلاعات موقعیت مکانی ایران (استان‌ها و شهرها)

این پکیج لاراول، لیست کامل استان‌های ایران و شهرهای وابسته به هر استان را فراهم می‌کند.

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) دریافت استان مربوط به یک شهر بر اساس نام

统计信息

  • 总下载量: 1.43k
  • 月度下载量: 0
  • 日度下载量: 0
  • 收藏数: 3
  • 点击次数: 0
  • 依赖项目数: 0
  • 推荐数: 0

GitHub 信息

  • Stars: 3
  • Watchers: 1
  • Forks: 0
  • 开发语言: PHP

其他信息

  • 授权协议: MIT
  • 更新时间: 2025-04-17