PHPackages                             bkfdev/laravel-address - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. bkfdev/laravel-address

ActiveLibrary[Utility & Helpers](/categories/utility)

bkfdev/laravel-address
======================

:package\_description

v2.0.5(2y ago)030MITPHP

Since May 23Pushed 2y ago1 watchersCompare

[ Source](https://github.com/aeq-dev/laravel-address)[ Packagist](https://packagist.org/packages/bkfdev/laravel-address)[ Docs](https://github.com/bkfdev/laravel-address)[ RSS](/packages/bkfdev-laravel-address/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (9)Dependencies (1)Versions (11)Used By (0)

LaravelAddress
==============

[](#laraveladdress)

[![Latest Version on Packagist](https://camo.githubusercontent.com/1a1641710e415633b5e3a9f8ba556a491cdefe5d326273a8685d4f12b6efce65/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626b666465762f6c61726176656c2d616464726573732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bkfdev/laravel-address)[![Total Downloads](https://camo.githubusercontent.com/a2e5b51bc72d837ed868712038502c16d9e9b1d52886182854cc29d6800d1aaf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f626b666465762f6c61726176656c2d616464726573732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bkfdev/laravel-address)[![Build Status](https://camo.githubusercontent.com/d25c2fe273a8d71b928f39b32b9197cd98b9b3a0cafe61f10955e9223959b91d/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f626b666465762f6c61726176656c2d616464726573732f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/bkfdev/laravel-address)[![StyleCI](https://camo.githubusercontent.com/cb13a877afd1dbe223c631789c3f922d3ace958fdb334a9cce9b26afefbc2ebd/68747470733a2f2f7374796c6563692e696f2f7265706f732f31323334353637382f736869656c64)](https://styleci.io/repos/12345678)

Laravel Address is a package to manage addresses that belong to your models. You can add addresses to any eloquent model with ease.

Installation
------------

[](#installation)

1. Install the package via composer:

    ```
    composer require bkfdev/laravel-address
    ```
2. Publish resources (migrations and config files):

    ```
    php artisan vendor:publish --provider="Bkfdev\Addressable\AddressesServiceProvider"
    ```
3. Run migrations:

    ```
    php artisan migrate
    ```
4. Done!

Usage
-----

[](#usage)

To add addresses support to your eloquent models simply use `\Bkfdev\Addressable\Traits\Addressable` trait.

### Manage your addresses

[](#manage-your-addresses)

```
// 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();
```

### Manage your addressable model

[](#manage-your-addressable-model)

The API is intuitive and very straight forward, so let's give it a quick look:

```
// 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();
```

Changelog
---------

[](#changelog)

Refer to the [Changelog](CHANGELOG.md) for a full history of the project.

Support
-------

[](#support)

Please raise a GitHub issue.

Testing
-------

[](#testing)

```
$ composer test
```

Contributing
------------

[](#contributing)

Please see [contributing.md](contributing.md) for details and a todolist.

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Author Name](https://github.com/bkfdev)
- [All Contributors](../../contributors)

License
-------

[](#license)

MIT. Please see the [license file](license.md) for more information.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~53 days

Recently: every ~1 days

Total

10

Last Release

975d ago

Major Versions

1.0.3 → 2.02023-09-08

### Community

Maintainers

![](https://www.gravatar.com/avatar/6d2469c45f2a6b752194eb41838268b9d199232d364f18be8597cd3c1da9c5e7?d=identicon)[aeq-dev](/maintainers/aeq-dev)

---

Top Contributors

[![aeq-dev](https://avatars.githubusercontent.com/u/81385994?v=4)](https://github.com/aeq-dev "aeq-dev (15 commits)")

---

Tags

laravelLaravelAddress

### Embed Badge

![Health badge](/badges/bkfdev-laravel-address/health.svg)

```
[![Health](https://phpackages.com/badges/bkfdev-laravel-address/health.svg)](https://phpackages.com/packages/bkfdev-laravel-address)
```

###  Alternatives

[highideas/laravel-users-online

This package will provide an online users management.

203113.2k1](/packages/highideas-laravel-users-online)[stephenjude/filament-blog

Filament Blog Builder

20317.8k](/packages/stephenjude-filament-blog)[ralphjsmit/laravel-helpers

A package containing handy helpers for your Laravel-application.

13704.6k2](/packages/ralphjsmit-laravel-helpers)[datomatic/nova-detached-actions

A Laravel Nova tool to allow for placing actions in the Nova toolbar detached from the checkbox selection mechanism.

11229.2k](/packages/datomatic-nova-detached-actions)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)