shimadotdev/iran-regions

一个包含伊朗省和城市数据的Laravel包，包括电话区号，同时具备地理定位功能。非常适合在Laravel应用程序中管理基于位置的信息。

维护者

详细信息

github.com/shimadotdev/iran-regions

来源

问题

安装: 37

依赖项: 0

建议者: 0

安全: 0

星星: 17

关注者: 1

分支: 0

开放性问题: 0

类型:laravel-package

1.2.1 2024-07-17 14:13 UTC

Requires

Requires (Dev)

MIT 5400431ca93e065abf3a8ed0bf1f005ebbb1fcf6

  • Shima .dev <hi.woop@shima.dev>

phplaraveliraniran-regionsiran-geo-coordinatesiran-cities

This package is not auto-updated.

Last update: 2024-09-25 15:18:39 UTC

README

Latest Stable Version Total Downloads Tests License PHP Version Require

Iran Regions Laravel Package

一个包含伊朗省和城市数据的Laravel包，包括电话区号，同时具备地理定位功能。非常适合在Laravel应用程序中管理基于位置的信息。

安装

您可以通过运行Composer来安装此包：

composer require shimadotdev/iran-regions

安装包后，运行以下Artisan命令以设置必要的迁移并将提供的数据填充到数据库中：

php artisan iran-regions:install

此命令将在您的数据库中创建名为cities和provinces的两个表，并填充所需的数据。

使用方法

安装包并运行迁移后，您可以使用提供的功能。

示例用法

您可以使用Iran类访问省和城市数据

use Shimadotdev\IranRegions\Iran;;

// Get a province by its slug
$province = Iran::province()->where('slug', '=', 'tehran')->first();

// Get all provinces with their slugs and calling codes
$provinces = Iran::province()->get(['slug', 'calling_code']);

//Update a city
$provinces = Iran::city()->where('slug', '=', 'qom')->update(['is_active'=> 0]);

//Relations
Iran::province()->with('cities')->get();

Iran::province()->find(3)->cities;

Iran::City()->with('province')->get();

Iran::City()->where('slug', 'naeen')->first()?->province->slug;

如您所见，您还可以利用Laravel的Eloquent ORM创建自定义查询并像通常一样与数据交互。

本地化支持

该包支持两种语言：英语（en）和波斯语（fa），包括所有城市和省的名字。您可以使用它们各自的缩写访问它们

trans('iranRegions::slug.' . $province->slug);

数据库结构

该包将在您的数据库中创建以下表

cities 表

provinces 表

测试

您可以使用PHPUnit运行包的自动化测试

phpunit

贡献

欢迎贡献！如果您有任何改进想法或发现任何问题，请通过GitHub问题提交或创建拉取请求。

安全漏洞

如果您发现任何安全漏洞，请通过电子邮件发送至hi@shima.dev

鸣谢

此包由Shima.Dev开发和维护

许可证

此包是开源软件，根据MIT许可证授权。