yajra / laravel-address
Laravel的菲律宾地址查找API。
v11.0.0
2024-04-15 14:00 UTC
Requires
- php: ^8.2
- illuminate/database: ^11.0
- illuminate/routing: ^11.0
- illuminate/support: ^11.0
- rap2hpoutre/fast-excel: ^5.4.0
- spatie/laravel-html: ^3.7
Requires (Dev)
- larastan/larastan: ^2.9
- orchestra/testbench: ^9
- pestphp/pest: ^2.34
- pestphp/pest-plugin-laravel: ^2.3
- phpunit/phpunit: ^10|^11
- rector/rector: ^1.0
README
为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以获取有关最近更改的更多信息。
贡献
请参阅CONTRIBUTING和CONDUCT以获取详细信息。
安全
如果您发现任何与安全相关的问题,请通过aqangeles@gmail.com发送电子邮件,而不是使用问题跟踪器。
鸣谢
许可
MIT许可(MIT)。请参阅许可文件以获取更多信息。