Laravel Endereços e Telefones

Pacote Laravel para países, estados, cidades e relacionamentos polimórficos de endereços e telefones.

Requisitos

• PHP 8.3+
• Laravel 10, 11, 12 ou 13
• Composer

Instalação

composer require andcarpi/laravel-endereco-e-telefone
php artisan migrate

As migrations são carregadas automaticamente pelo service provider.

Dados geográficos

Os comandos consultam a API pública do IBGE e podem ser executados novamente com segurança:

php artisan enderecos:seed

Também é possível executar separadamente:

php artisan enderecos:seed-paises
php artisan enderecos:seed-estados
php artisan enderecos:seed-cidades

Traits

Adicione as traits ao model que terá endereços ou telefones:

use andcarpi\LaravelEnderecoETelefone\Traits\TemEnderecos;
use andcarpi\LaravelEnderecoETelefone\Traits\TemTelefones;

class Pessoa extends Model
{
    use TemEnderecos;
    use TemTelefones;
}

Exemplo:

$pessoa->enderecos()->create([
    'endereco' => 'Rua A',
    'numero' => '100',
    'bairro' => 'Centro',
    'cep' => '01000-000',
    'cidade_id' => 1,
]);

$pessoa->telefones()->create([
    'numero' => '11999999999',
    'descricao' => 'Celular',
]);

$pessoa->temEnderecos();
$pessoa->temTelefones();

Os métodos enderecos() e telefones() permitem vários registros; endereco() e telefone() retornam o primeiro relacionamento.

Desenvolvimento

composer install
composer test
composer lint

O método Endereco::fromCEP() está reservado para implementação futura.