README

📌 Sobre o projeto

O Laravel Has UUID é um pacote enxuto que adiciona uma única trait para gerar automaticamente chaves primárias do tipo UUID em modelos Eloquent. Ele é ideal para projetos que desejam substituir IDs auto incrementais por identificadores universais sem repetir código.

✨ Funcionalidades

🔄 Geração automática de UUID: atribui um UUID v4 ou v7 sempre que um modelo é criado e ainda não possui um valor definido para a chave primária.
🔐 Configuração adequada do modelo: força o uso de chaves não incrementais e do tipo string, requisitos essenciais para trabalhar com UUIDs no Eloquent.

🚀 Instalação

1️⃣ Requisitos

Certifique-se de que seu projeto atende aos seguintes requisitos:

PHP >= 8.3
Laravel 12.x
Composer instalado

2️⃣ Instalação do pacote

Execute o comando abaixo no terminal:

  composer require risetechapps/has-uuid-for-laravel

3️⃣ Configure seu model

Adicione a trait HasUuid ao seu modelo Eloquent:

use Illuminate\Database\Eloquent\Model;
use RiseTechApps\HasUuid\Traits\HasUuid;

class Client extends Model
{
    use HasUuid;
}

A trait irá preencher automaticamente a chave primária com um UUID caso você não defina um valor manualmente.

🛠 Contribuição

Sinta-se à vontade para contribuir! Basta seguir estes passos:

Faça um fork do repositório
Crie uma branch (feature/minha-melhoria)
Faça um commit das suas alterações
Envie um Pull Request

📜 Licença

Este projeto é distribuído sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

💡 Desenvolvido por Rise Tech

risetechapps / has-uuid-for-laravel

Maintainers

Details