README

Laravel-Algereography

Laravel-Algereography 允许您将阿尔及利亚省和迪亚拉的迁移、种子和模型添加到现有的或新的酷炫Laravel项目中。

- 58个省。
- 548个迪亚拉。
- 支持阿拉伯语和法语。
- 内置模型关系，例如：您可以使用 Daira::find(1)->wilaya 来获取ID为1的迪亚拉所在的省。

安装

步骤1 - 需求包

composer require thehocinesaad/laravel-algereography

步骤2：安装包

php artisan algereography:install

此命令将为您完成以下操作

1. 发布两个模型，Wilaya 和 Daira 到 app/Models。

2. 发布两个迁移，create_wilayas_table 和 create_dairas_table 到 database/migrations

3. 发布两个种子器，WilayaSeeder 和 DairaSeeder 到 database/seeders

4. 运行两个迁移（create_wilayas_table 和 create_dairas_table）
   注意：此操作将自动覆盖所有名为 wilayas 和 dairas 的表

5. 运行两个种子器（WilayaSeeder 和 DairaSeeder）

6. 最后，它会打印 完成！ 告诉您一切已成功完成，然后它会打印 1 2 3 Viva l'Algérie! 只是为了让您为自己的国家感到一丝自豪 ❤️

步骤3

没有步骤3，您已完成 😉
检查您的数据库，您将找到两个新表，wilayas 和 dairas。

如何使用包

如前所述，该包发布两个模型 Wilaya 和 Daira，就像在项目中使用任何其他模型一样使用它们。

获取所有省

Wilaya::all();

获取所有迪亚拉

Daira::all();

获取一个省的迪亚拉

Wilaya::findOrFail(15)->dairas

获取一个迪亚拉的省

Daira::findOrFail(205)->wilaya;

注意：不要忘记首先导入模型

use App\Models\Wilaya;
use App\Models\Daira;

辅助工具

您还可以使用我添加的一些辅助工具来简化您的操作。

辅助工具列表

$wilayas     =   wilayas();           // Get all Wilayas in all languages
$ar_wilayas  =   wilayas('ar');       // Get all Wilayas in arabic
$ar_wilayas  =   wilayas('fr');       // Get all Wilayas in french

//

$wilaya      =   wilaya(15);          // Get individuel Wilaya in all languages
$ar_wilaya   =   wilaya(15, 'ar');    // Get individuel Wilaya in arabic
$wilaya      =   wilaya(15, 'fr');    // Get individuel Wilaya in french

//

$dairas      =   dairas();            // Get all Dairas in all languages             
$ar_dairas   =   dairas('ar');        // Get all Dairas in arabic 
$fr_dairas   =   dairas('fr');        // Get all Dairas in french

//

$dairas      =   dairasOf(15);        // Get all Dairas of a Wilaya in all languages
$dairas      =   dairasOf(15, 'ar');  // Get all Dairas of a Wilaya in arabic
$dairas      =   dairasOf(15, 'fr');  // Get all Dairas of a Wilaya in french

当指定语言时，要访问名称属性，只需这样做 ->name，它将自动获取正确语言中的名称，因此无需执行 ->ar_name 来获取阿拉伯语中的名称。

示例

$fr_wilaya  =  wilaya(15, 'fr');   // $fr_wilaya->name will be 'Tizi Ouzou' 
$ar_wilaya  =  wilaya(15, 'ar');   // $ar_wilaya->name will be 'تيزي وزو' 

多么酷啊！

贡献

感谢您考虑为 Laravel-Algereography 项目做出贡献！请随意以任何方式做出贡献，我们欢迎每一个贡献。

许可

Laravel-Algereography 项目是开源软件，根据 MIT 许可证 许可。