README

介绍

"provinces" Laravel包提供了管理阿富汗省份和区的基本资源。该包包括模型、迁移、种子和工厂，以方便将阿富汗的行政区划集成到您的项目中。

要求

使用此包之前，请确保您的Laravel应用满足以下要求

安装

您可以使用Composer轻松安装"provinces"包。打开您的终端并运行以下命令

composer require open-afghanistan/provinces

迁移

安装成功后，您需要发布迁移文件。使用以下Artisan命令

php artisan vendor:publish --tag=provinces-migration

此命令将在数据库中生成一个迁移文件，设置省份和区的必要表。

种子

该包包括一个实用的ProvincesSeeder，可以填充34个阿富汗省份及其相应的区。您可以在项目的数据库种子文件中调用此种子器，如下所示

// DatabaseSeeder.php

use OpenAfghanistan\Provinces\Database\Seeders\ProvincesSeeder;

$this->call(ProvincesSeeder::class);

如果您只想填充特定的省份，可以单独调用它们的种子类

// DatabaseSeeder.php

use OpenAfghanistan\Provinces\Database\Seeders\KabulProvinceSeeder;

$this->call(KabulProvinceSeeder::class);

工厂

为了便于测试，该包提供了省份和区的工厂。您可以在测试中轻松创建这些模型的实例

对于省份

use OpenAfghanistan\Provinces\Models\Province;

Province::factory()->create();

对于区

use OpenAfghanistan\Provinces\Models\District;

District::factory()->create();

贡献指南

我们欢迎贡献以增强此包。如果您想通过添加任何省份的区来贡献，每个省份都有可用的特定种子文件以简化流程。在推送任何代码片段之前，请运行./vendor/bin/pint命令。

许可

"provinces"包是开源软件，根据MIT许可证分发。您可以根据项目需求自由使用和修改。

请随意使用此包，在您的Laravel应用中轻松管理阿富汗的行政区划。

open-afghanistan / 省份