Download the PHP package coresuit/migration-gen-laravel without Composer
On this page you can find all versions of the php package coresuit/migration-gen-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download coresuit/migration-gen-laravel
More information about coresuit/migration-gen-laravel
Files in coresuit/migration-gen-laravel
Package migration-gen-laravel
Short Description Gerador de migrations por entidade e campos (CoreSuit style) para Laravel
License MIT
Informations about the package migration-gen-laravel
CoreSuit Migration Gen (Laravel)
Gerador de Migration + Model + Repository/Interface + Service/Interface + Requests + Controller com injeção automática de Rotas e Providers para projetos Laravel — no estilo CoreSuit.
Compatível com Laravel 11/12+ e PHP >= 8.2
Sumário
- Instalação no seu projeto (consumidor)
- Primeiros passos (init)
- Como gerar uma entidade
- Sintaxe de campos (
--fields) - Arquivos e estrutura gerada
- Customização com stubs e namespaces
- Injeção de rotas e providers
- Comandos disponíveis
- Como usar o pacote em outro projeto Laravel
- Como publicar uma nova versão no Packagist (maintainer)
- Boas práticas de versionamento
- Solução de problemas (FAQ)
- Licença
Instalação no seu projeto (consumidor)
Pré-requisitos: Projeto Laravel com Composer configurado.
Instale a versão estável mais recente:
Ou uma faixa específica (ex.: série 1.3):
Se (temporariamente) você precisa testar a branch de desenvolvimento:
Não recomendado para produção.
Primeiros passos (init)
Antes de gerar entidades, execute o init para preparar bases de Repository/Service/DTO/Requests/Controller, registrar Providers, criar OpenAPI bootstrap e rota de health.
O que o init faz:
- Cria bases em:
app/Repositories,app/Services,app/DTOs/Sharedapp/Http/Requests/Shared,app/Http/Controllers/Shared
- Cria
app/OpenApi/OpenApi.php(bootstrap OpenAPI). - Registra providers (
RepositoryServiceProvidereServicesServiceProvider) usando marcador[coresuit_providers]. - Gera rota
/api/healthe controller de health check. - Cria flag
bootstrap/cache/coresuit_init.flagque libera o gerador.
Swagger (opcional): para documentação da API com L5 Swagger
Como gerar uma entidade
Exemplo criando Pedido com campos e relacionamentos:
Depois, aplique a migration:
O que é criado
- Migration:
database/migrations/<timestamp>_create_pedidos_table.php - Model:
app/Models/Pedido.php - Repository + Interface
- Service + Interface
- Requests (List/Store/Update)
- Controller REST
- Rotas (prefixo
pedidopor padrão) - Providers (binds automáticos)
Sintaxe de campos (--fields)
Formato: nome:type:required, separados por vírgula.
- nome: será normalizado para
snake_case. - type:
string,text,int/integer,bigint,decimal,bool/boolean,date,datetime,json. - required:
true|false(controlanullable()e validações).
Exemplo completo:
Regra especial: campos que terminam com _id
- Geram
belongsToautomaticamente no Model (ex.:cliente()). - Criam foreign key na migration (
references('id')->on('clientes')).
Impactos por tipo:
- Migration:
string,text,unsignedInteger,unsignedBigInteger,decimal(18,2),boolean,date,dateTime,json. - Model: adiciona casts adequados (ex.:
decimal:2,boolean,array,date,datetime). - Requests: validações, sanitização (ex.: trim/boolean) e filtros no
ListRequest(query paramsfilters[...]).
Arquivos e estrutura gerada
Customização com stubs e namespaces
Você pode apontar stubs personalizados e alterar namespaces/diretórios:
Flags úteis: --no-migration, --no-model, --no-repo, --no-service, --no-requests, --no-controller, --no-routes, --no-providers, --force.
Injeção de rotas e providers
Rotas (em routes/api.php) com grupo de middleware (default auth.jwt) e marcador:
Providers: binds injetados em RepositoryServiceProvider e ServicesServiceProvider abaixo do marcador // [coresuit_providers].
Comandos disponíveis
php artisan coresuit:make-migration init— prepara o projeto (bases, providers, OpenAPI, health, flag).php artisan coresuit:make-entity --name=... --fields="..."— gera stack CRUD.
Ajuda rápida:
Como usar o pacote em outro projeto Laravel
-
Instale o pacote:
-
Execute o init (uma vez por projeto):
-
Gere entidades conforme necessidade:
- Customize (opcional): publique stubs para editar templates
Como publicar uma nova versão no Packagist (maintainer)
Para o mantenedor do pacote.
-
Garanta commits na
master: -
Crie a tag semântica e envie:
- Atualize no Packagist:
- Manual: botão Update na página do pacote; ou
- Automático (recomendado): Configure um webhook no GitHub
- Settings → Webhooks → Add webhook
- Payload URL:
https://packagist.org/api/github - Content type:
application/json - Events: Just the push event
Importante: evite manter "version" no composer.json. Deixe o Packagist inferir a versão pela tag.
Se optar por manter "version", ela deve ser exatamente igual à tag (ex.: 1.3.0).
Corrigir tag equivocada:
Boas práticas de versionamento
- MAJOR
2.0.0: mudanças que quebram compatibilidade. - MINOR
1.3.0 -> 1.4.0: novas features compatíveis. - PATCH
1.3.0 -> 1.3.1: correções e micro melhorias. - Use CHANGELOG (Releases do GitHub) para destacar mudanças.
Solução de problemas (FAQ)
“Could not find a version matching your minimum-stability (stable)”
- Publique uma tag estável (ex.:
v1.0.0) OU instale:dev-mastertemporariamente. - Alternativa:
“Some tags were ignored because of a version mismatch in composer.json”
- Remova
"version"docomposer.jsonou sincronize com a tag. - Clique Update no Packagist (ou configure webhook).
“Not auto-updated” no Packagist
- Ative o webhook do GitHub:
https://packagist.org/api/github(eventopush).
“tag already exists” ao criar nova tag
coresuit:make-entity acusa que init não foi executado
- Rode:
php artisan coresuit:make-migration init
Licença
MIT — ver LICENSE.
All versions of migration-gen-laravel with dependencies
illuminate/console Version ^12.0
illuminate/support Version ^12.0
illuminate/filesystem Version ^12.0