andcarpi/laravel-endereco-e-telefone

Países, estados, cidades, endereços e telefones para aplicações Laravel.

0.6 2026-08-11 15:50 UTC

Requires

• php: ^8.3
• illuminate/console: ^10.0|^11.0|^12.0|^13.0
• illuminate/database: ^10.0|^11.0|^12.0|^13.0
• illuminate/http: ^10.0|^11.0|^12.0|^13.0
• illuminate/support: ^10.0|^11.0|^12.0|^13.0

Requires (Dev)

• laravel/pint: ^1.18
• orchestra/testbench: ^8.0|^9.0|^10.0|^11.0
• phpunit/phpunit: ^10.0|^11.0|^12.0

MIT

• Anderson Carpi

Published on Packagist.org on 2026-08-11 15:54 UTC

README

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.