README

Laravel Address 是一个用于管理属于您的模型地址的包。您只需轻松地将地址添加到任何 eloquent 模型。

安装

1. 使用 composer 安装此包

   composer require bkfdev/laravel-address

2. 发布资源（迁移和配置文件）

   php artisan vendor:publish --provider="Bkfdev\Addressable\AddressesServiceProvider"

3. 运行迁移

   php artisan migrate

4. 完成！

使用方法

要为您的 eloquent 模型添加地址支持，只需使用 \Bkfdev\Addressable\Traits\Addressable 特性。

管理您的地址

// Get instance of your model
$user = new \App\Models\User::find(1);

// Create a new address
$user->addresses()->create([
    'label' => 'Default Address',
    'country_code' => 'dz',
    'street' => '56 john doe st.',
    'state' => 'Canterbury',
    'city' => 'Christchurch',
    'postal_code' => '7614',
    'latitude' => '31.2467601',
    'longitude' => '29.9020376',
    'is_primary' => true,
]);

// Create multiple new addresses
$user->addresses()->createMany([
    [...],
    [...],
    [...],
]);

// Find an existing address
$address = Bkfdev\Addressable\Models\Address::find(1);

// Update an existing address
$address->update([
    'label' => 'Default Work Address',
]);

// Delete address
$address->delete();

// Alternative way of address deletion
$user->addresses()->where('id', 123)->first()->delete();

管理您的地址模型

API 直观且简单易用，让我们快速了解一下

// Get instance of your model
$user = new \App\Models\User::find(1);

// Get attached addresses collection
$user->addresses;

// Get attached addresses query builder
$user->addresses();

// Scope Primary Addresses
$primaryAddresses = Bkfdev\Addressable\Models\Address::isPrimary()->get();

// Scope Addresses in the given country
$algerianAddresses = Bkfdev\Addressable\Models\Address::inCountry('dz')->get();

更新日志

有关项目的完整历史，请参阅更新日志。

支持

请在 GitHub 上提出问题。

测试

$ composer test

贡献

有关详细信息和使用列表，请参阅 contributing.md。

安全

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

致谢

• 作者姓名
• 所有贡献者

许可证

MIT。有关更多信息，请参阅 许可证文件。