elbrahms/niger-location

此包提供了一种简单的方法来获取尼日尔共和国(NE:+227)的地区、部门、市镇和地方,您可能需要这些信息用于您的应用程序——例如,用于下拉菜单。

v1.1 2024-09-01 12:54 UTC

This package is auto-updated.

Last update: 2024-10-01 14:05:13 UTC


README

hero

介绍 🖖

此包提供了一种简单的方法来获取尼日尔共和国(NE:+227)的地区、部门、市镇和地方,您可能需要这些信息用于您的应用程序——例如,用于下拉菜单。

第一步 - 通过Composer安装 🎼

通过composer将包添加到您的项目中

composer require elbrahms/niger-location

composer install

第二步 - 发布配置 ⚙️

Laravel位置提供了一种简单的方式来自定义用于存储国家、州和城市的表。您还可以自定义路由前缀和中间件。要自定义这些,您需要发布配置文件。要发布配置文件,请运行

php artisan vendor:publish --tag=niger-location

您将有一个可供编辑的config/location.php文件。默认配置如下

<?php

return [
    'countries_table' => 'countries',
    'regions_table' => 'regions',
    'departements_table' => 'departements',
    'communes_table' => 'communes',
    'localites_table' => 'localites',
    'country_initial_id' => 159, //for Niger Republic
    'routes' => [
        'prefix' => 'location',
        'middleware' => 'web'
    ]
];

您可以在运行迁移之前自定义表名路由前缀中间件。自定义完成后,运行迁移。

第三步 - 运行迁移

在执行此操作之前,请确保您的正确数据库凭据已设置在.env文件中

php artisan migrate

migrations

最后,运行包的种子器

php artisan db:seed --class=Elbrahms\NigerLocation\Database\Seeders\LocationDatabaseSeeder

seeders

用法 🧨

注意
以下路由使用默认配置的location前缀设置在config/location.php文件中。如果已更改,请用正确的前缀替换您的路由中的前缀。

以下是英文表格

此表格列出了您代码中定义的路由,并简要说明了每个路由返回的内容。

测试

composer test

贡献

免费提供,如果您发现该包有问题或如果您发现有人创建了一个新的国家,请提交PR。