Download the PHP package alberto255345/schema-differ without Composer
On this page you can find all versions of the php package alberto255345/schema-differ. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download alberto255345/schema-differ
More information about alberto255345/schema-differ
Files in alberto255345/schema-differ
Package schema-differ
Short Description Framework para gerar migrations de diff comparando schema esperado e o atual do banco de dados
License MIT
Informations about the package schema-differ
Schema Differ
O Schema Differ é um framework para gerar migrations de diff que comparam o schema esperado (definido por suas migrations ou entidades) com o schema atual do banco de dados. Ele automatiza a criação de migrations com os métodos up
e down
para sincronizar o banco de dados conforme as alterações detectadas, facilitando a manutenção e evolução do seu sistema.
Recursos
- Extração do Schema Atual: Obtém informações do banco (exemplo fictício) ou pode ser estendido para usar _informationschema ou métodos nativos do Laravel.
- Extração do Schema Esperado: Utiliza definições (exemplo fixo) das migrations ou das entidades.
- Comparação de Schemas: Identifica tabelas ou colunas ausentes e outras diferenças.
- Geração Automática de Migration: Cria um arquivo de migration contendo os métodos
up
(para aplicar as mudanças) edown
(para reverter). - Comando Artisan: Fornece o comando
diff:migration
para executar o processo diretamente via linha de comando. - PSR-4 Autoload: Compatível com a estrutura de autoload do Composer.
Estrutura do Pacote
Instalação
Via Packagist
Adicione o pacote ao seu projeto Laravel utilizando o Composer:
Configuração para Laravel
Se o seu projeto Laravel não estiver usando o auto-discovery, adicione o Service Provider manualmente no arquivo config/app.php
:
Uso
Executando o Comando Artisan
O pacote registra o comando Artisan diff:migration
. Para gerar a migration que reflete a diferença entre o schema esperado e o atual, execute:
Esse comando realizará os seguintes passos:
- Instanciará a classe
SchemaDiffer
, que compara o schema atual (exemplo fictício) com o schema esperado. - Gerará o conteúdo da migration com os métodos
up
edown
. - Criará um arquivo de migration na pasta
database/migrations
com um nome baseado em timestamp (ex.:2025_02_11_123456_diff_migration_generated.php
).
Detalhes Técnicos
-
Escapamento de Variáveis:
O código gerado para a migration usa heredoc para incluir trechos do Blueprint do Laravel. Note que, dentro das strings, os sinais de dólar são escapados (ex.:\$table
) para que o código gerado contenha literalmente$table
e não tente interpretar variáveis durante a execução do comando. -
Regeneração do Autoload:
Se você realizar alterações no pacote ou na sua estrutura, execute:para garantir que todas as classes sejam carregadas corretamente.
Atualizando o Pacote
Após realizar alterações no seu pacote, siga estes passos para atualizar a versão no GitHub e no Packagist:
-
Atualize o
composer.json
(opcional):
Atualize a chave"version"
se desejar (por exemplo,"version": "1.0.2"
). -
Commit e Push:
-
Crie uma Tag no Git:
- Packagist:
Se o webhook estiver configurado, o Packagist atualizará automaticamente. Caso contrário, acesse a página do pacote no Packagist e clique em "Update" para forçar a atualização.
Problemas Comuns
-
Extensão bcmath:
Caso alguma dependência (por exemplo,moneyphp/money
) exija a extensãobcmath
e ela não esteja instalada, você pode instalar via:(Ajuste a versão conforme sua instalação do PHP.)
- Mensagens do Xdebug:
As mensagens do Xdebug podem aparecer durante a execução do Composer ou Artisan. Geralmente, elas não impedem o funcionamento do pacote, mas se desejar, você pode desabilitar o Xdebug temporariamente.
Contribuição
Contribuições são muito bem-vindas! Abra issues ou envie pull requests para ajudar a melhorar o pacote.
Licença
Este projeto está licenciado sob a Licença MIT.
Contato
Em caso de dúvidas ou sugestões, abra uma issue em GitHub Issues.