yajra/laravel-address

Laravel的菲律宾地址查找API。

v11.0.0 2024-04-15 14:00 UTC

README

Latest Version on Packagist Continuous Integration Static Analysis Quality Score Total Downloads Software License

为Laravel提供菲律宾地址查找API的包。

安装

$ composer require yajra/laravel-address

注册服务提供者(Laravel 5.5+可选)

Yajra\Address\AddressServiceProvider::class

发布配置(可选)

$ php artisan vendor:publish

可用配置

address.prefix 修改API基本路由。

address.middleware 路由中间件。

必需设置(迁移和种子文件)

  • 运行地址迁移。
php artisan migrate
  • 运行地址种子文件。
php artisan db:seed Yajra\\Address\\Seeders\\AddressSeeder

路由

API路由的默认前缀为/api/address。可以通过配置文件address.php更新默认值。

  • 获取所有地区 /api/address/regions
  • 获取所有省份 /api/address/provinces
  • 根据地区获取省份 /api/address/provinces/{regionId}
  • 根据省份获取城市 /api/address/cities/{provinceId}
  • 根据城市获取村庄 /api/address/barangays/{cityId}

使用示例

添加地址迁移

使用 $table->address() 添加地址迁移。这将添加以下字段

  • street
  • barangay_id
  • city_id
  • province_id
  • region_id

包含内置表单(需要jQuery)

在你的视图中包含 @include('address::form', ['model' => $modelWithAddress])

在主布局中添加脚本部分。

在body标签的末尾之前,包含 @stack('scripts')

<body>
-- Contents Here ---

<script src="/vendor/jquery.js"></script>
@stack('scripts')
</body>

模型与地址集成

只需在您的模型上使用 Yajra\Address\HasAddress 特性来加载地址模型关系。

use Yajra\Address\HasAddress;

class User extends Model {
    use HasAddress;
}

变更日志

请参阅CHANGELOG以获取有关最近更改的更多信息。

贡献

请参阅CONTRIBUTINGCONDUCT以获取详细信息。

安全

如果您发现任何与安全相关的问题,请通过aqangeles@gmail.com发送电子邮件,而不是使用问题跟踪器。

鸣谢

许可

MIT许可(MIT)。请参阅许可文件以获取更多信息。