live-controls / address

v1.2.3 2026-09-30 20:03 UTC

Requires (Dev)

• larastan/larastan: ^3.0
• orchestra/testbench: ^11

MIT

• Roman Wanner

Published on Packagist.org on 2026-09-30 20:04 UTC

README

Simple address manipulation for Laravel with database storage

Installation

1. Require from composer:

composer require live-controls/address;

1. Publish migrations:

php artisan vendor:publish --tag="live-controls.address.migrations";

Address Model Fields

The address model has the following fields:

• key: nullable|string|index
• country_code: string
• state: string
• city: string
• postal_code: string
• street: string
• number: string
• complement: nullable|string
• neighborhood: string
• latitude: nullable|decimal
• longitude: nullable|decimal

Single address

1. Add the following trait to your model:

use LiveControls\Address\Traits\HasAddress;

class SomeModel extends Model
{
    use HasAddress;

    /* ... */
}

1. To store the address afterwards simply call:

$address = [
    'country_code' => 'BR',
    'state' => 'MG',
    'city' => 'Belo Horizonte',
    'postal_code' => '30830000',
    'street' => 'Avenida Abilio Machado',
    'number' => '965',
    'complement' => 'Apt 1103',
    'neighborhood' => 'Alípio de Melo',
    'latitude' => -19.9044486,
    'longitude' => -44.0021370,
];

$model->updateAddress($address);

1. To return it's Address model simply call:

$model->address;

1. To remove the Address do:

$model->deleteAddress();

Multiple addresses

1. Add the following trait to your model:

use LiveControls\Address\Traits\HasAddresses;

class SomeModel extends Model
{
    use HasAddresses;

    /* ... */
}

1. To store the addresses afterwards simply call:

$address = [
    'country_code' => 'BR',
    'state' => 'MG',
    'city' => 'Belo Horizonte',
    'postal_code' => '30830000',
    'street' => 'Avenida Abilio Machado',
    'number' => '965',
    'complement' => 'Apt 1103',
    'neighborhood' => 'Alípio de Melo',
    'latitude' => -19.9044486,
    'longitude' => -44.0021370,
];

$model->updateAddress('main', $address);

1. To return it's Address model simply call:

$model->addressWithKey('main');

1. To remove the Address do:

$model->deleteAddress('main');