PHPackages                             risetechapps/address-for-laravel - 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. risetechapps/address-for-laravel

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

risetechapps/address-for-laravel
================================

1.3.1(1mo ago)0310—0%1MITPHPPHP ^8.3

Since May 23Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/risetechapps/address-for-laravel)[ Packagist](https://packagist.org/packages/risetechapps/address-for-laravel)[ Docs](https://github.com/risetechapps/address-for-laravel)[ RSS](/packages/risetechapps-address-for-laravel/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (14)Versions (7)Used By (1)

🏠 Laravel Address
=================

[](#-laravel-address)

**Laravel Address** é um pacote para Laravel que permite gerenciar diferentes tipos de endereços (padrão, entrega e cobrança) associados aos seus models de forma simples e eficiente.

---

📦 Instalação
------------

[](#-instalação)

### ✅ Requisitos

[](#-requisitos)

- PHP >= 8.3
- Laravel >= 12
- Composer

### ⚙️ Passo a Passo

[](#️-passo-a-passo)

1. Instale o package via Composer:

```
  composer require risetechapps/address-for-laravel
```

2. Adicione as traits ao seu model:

```
use RiseTechApps\Address\Traits\HasAddress\HasAddress;
use RiseTechApps\Address\Traits\HasAddress\HasAddressBilling;
use RiseTechApps\Address\Traits\HasAddress\HasAddressDelivery;

class Client extends Model
{
    use HasFactory, HasAddress, HasAddressDelivery, HasAddressBilling;
}
```

3. Execute as migrations:

```
  php artisan migrate
```

---

✨ Funcionalidades
-----------------

[](#-funcionalidades)

- 🏷 **Address:** Endereço padrão para qualquer model.
- 🏷 **Address Delivery:** Suporte a múltiplos endereços de entrega.
- 🏷 **Address Billing:** Suporte a múltiplos endereços de cobrança.

---

💡 Exemplos de Uso
-----------------

[](#-exemplos-de-uso)

### Criar um endereço padrão

[](#criar-um-endereço-padrão)

```
$client = Client::find(1);

$client->address()->create([
    'street' => 'Rua Exemplo',
    'number' => '123',
    'city' => 'São Paulo',
    'state' => 'SP',
    'zipcode' => '01234-567',
]);
```

### Adicionar endereço de entrega

[](#adicionar-endereço-de-entrega)

```
$client->deliveryAddresses()->create([
    'street' => 'Av. das Entregas',
    'number' => '456',
    'city' => 'Campinas',
    'state' => 'SP',
    'zipcode' => '13000-000',
]);
```

### Adicionar endereço de cobrança

[](#adicionar-endereço-de-cobrança)

```
$client->billingAddresses()->create([
    'street' => 'Rua da Cobrança',
    'number' => '789',
    'city' => 'Ribeirão Preto',
    'state' => 'SP',
    'zipcode' => '14000-000',
]);
```

### Enviando um request com endereço incluído

[](#enviando-um-request-com-endereço-incluído)

Caso envie um payload contendo `address`, `address_billing` ou `address_delivery`, os dados serão automaticamente persistidos com o model:

```
{
  "name": "João da Silva",
  "email": "joao@example.com",
  "address": {
    "street": "Rua Principal",
    "number": "100",
    "city": "São Paulo",
    "state": "SP",
    "zipcode": "01000-000"
  },
  "address_billing": [
    {
      "street": "Rua da Fatura",
      "number": "200",
      "city": "São Paulo",
      "state": "SP",
      "zipcode": "02000-000"
    }
  ],
  "address_delivery": [
    {
      "street": "Av. das Entregas",
      "number": "300",
      "city": "Campinas",
      "state": "SP",
      "zipcode": "13000-000"
    }
  ]
}
```

Esse comportamento é automático desde que seu controller/model esteja configurado para aceitar os relacionamentos e realizar a persistência corretamente.

---

🧪 Testes
--------

[](#-testes)

Para rodar os testes, execute:

```
  php artisan test
```

Ou usando PHPUnit diretamente:

```
  ./vendor/bin/phpunit
```

Certifique-se de que todas as dependências estão instaladas e o ambiente `.env.testing` está configurado corretamente.

---

🤝 Como Contribuir
-----------------

[](#-como-contribuir)

Contribuições são super bem-vindas! Para colaborar:

1. Faça um fork do repositório
2. Crie uma branch com sua feature (`feature/nome-da-feature`)
3. Faça o commit das suas alterações
4. Envie um Pull Request

---

📄 Licença
---------

[](#-licença)

Este projeto é licenciado sob a licença MIT. Consulte o arquivo [LICENSE](LICENSE) para mais detalhes.

---

💡 Autor
-------

[](#-autor)

Desenvolvido com 💙 por [Rise Tech](https://risetech.com.br)

###  Health Score

45

—

FairBetter than 92% of packages

Maintenance88

Actively maintained with recent releases

Popularity16

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity56

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 ~23 days

Total

5

Last Release

58d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ae96932429c94085ffc00280225c32499cfdcadeae88237c27e095cfc67a5485?d=identicon)[risetechapps](/maintainers/risetechapps)

---

Top Contributors

[![risetechapps](https://avatars.githubusercontent.com/u/160299136?v=4)](https://github.com/risetechapps "risetechapps (61 commits)")

---

Tags

addressrisetechapps

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

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

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

###  Alternatives

[nonsapiens/realaddressfactory

Creates real-world street addresses from Google Maps, to use in database seeding, unit tests, or anything else. Supports Laravel 11+, and Faker

4910.2k7](/packages/nonsapiens-realaddressfactory)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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