Pular para o conteúdo principal

Mesclador de Overlay INI

API reference

Mescle um arquivo INI de configuração com um ou dois arquivos de overlay, do jeito que um deploy combina padrões, ambiente e configurações locais. Os valores substituídos são editados no próprio lugar, então os comentários, as linhas em branco, a ordem das chaves e a indentação do arquivo base são preservados, e um relatório de alterações mostra exatamente quais chaves foram adicionadas, alteradas ou mantidas.

Entrada

Os padrões. Os comentários, a ordem e a formatação deste arquivo são o que a saída mesclada mantém.

Aplicado sobre a base. Somente as chaves que ele indica são alteradas.

Aplicado por último, então prevalece sobre o primeiro overlay. Deixe em branco para uma mesclagem simples de dois arquivos.

Opções

Um comentário inline na própria linha de uma chave é sempre mantido, mesmo com esta opção desativada.

Saída

INI mesclado
 
Alterações
SeçãoChaveValor baseValor mescladoAlteração
No data yet
Isso foi útil?

Mais formas de usar esta ferramenta

API REST

curl -X POST https://api.iotools.cloud/v1/tool/ini-overlay-merger \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "baseIni": "; Application defaults — keep this file in versi…",
    "overlayIni": "; production.ini\ndebug = true\n\n[server]\nhost = 0…",
    "secondOverlayIni": "",
    "newKeys": "add",
    "preserveComments": "true",
    "ignoreCase": "",
    "assignment": "spaced"
  }'

Troque pela sua própria chave, da sua conta. Os campos da ferramenta viram o corpo da requisição — sem envelope.

Peça a um agente de IA

Use the IOTools `ini-overlay-merger` tool (INI Overlay Merger) on this input:

YOUR_INPUT_HERE

Cole isto em qualquer agente conectado ao servidor MCP do IOTools e depois adicione sua entrada.

Widget para incorporar

<iframe
  src="https://iotools.cloud/embed/ini-overlay-merger/"
  width="100%" height="520" frameborder="0" scrolling="no" loading="lazy"
  title="Mesclador de Overlay INI — iotools.cloud"
  sandbox="allow-scripts allow-forms allow-same-origin allow-downloads allow-popups allow-popups-to-escape-sandbox"
  allow="clipboard-write"
  style="width:100%;border:1px solid #e5e7eb;border-radius:12px;overflow:hidden"></iframe>
<script src="https://iotools.cloud/embed.js" async></script>

Coloque isso na sua própria página — grátis, sem chave, só um link de volta.

Custo por chamada de API/MCPA partir de 5 créditos
Precisa de mais créditos?Ver preços

Também disponível via

Guias

O que esta ferramenta faz

A maioria dos projetos baseados em INI mantém um arquivo de padrões e um pequeno arquivo por ambiente: app.ini mais production.ini, ou defaults.ini → staging.ini → local.ini. Resolver essas camadas à mão é onde os erros surgem: uma chave passa despercebida, ou um valor antigo da base sobrevive até a produção.

Esta ferramenta aplica um overlay sobre um INI base e mostra o arquivo resolvido, além de um relatório com exatamente quais chaves foram adicionadas, alteradas ou mantidas.

A maioria das ferramentas de mesclagem passa os dois arquivos por um objeto e serializa o resultado de novo, o que destrói silenciosamente todos os comentários e reordena suas chaves. Esta não faz isso. Ela edita os valores no próprio lugar do arquivo base, então comentários, linhas em branco, ordem das chaves, indentação e até um comentário inline na linha que está sendo sobrescrita sobrevivem à mesclagem. O resultado é um arquivo que você pode commitar.

Como usar

  1. Cole o INI base (seus padrões) na primeira caixa.
  2. Cole o overlay, o arquivo específico do ambiente, na segunda.
  3. Opcionalmente, adicione um segundo overlay. Ele é aplicado por último, então prevalece sobre o primeiro: padrões → ambiente → local, na ordem em que os deploys realmente os resolvem.
  4. Leia a tabela de Alterações e depois copie ou baixe o INI mesclado.

Tudo acontece no seu navegador. Nenhum dos arquivos é enviado.

Configurações

  • Chaves que existem só no overlay: Adicioná-las (padrão) acrescenta ao fim da seção uma chave que a base nunca declarou, criando a seção no fim do arquivo se necessário. Ignorá-las mescla apenas as chaves que a base já declara. Isso é o que você quer quando a base é o esquema oficial e um erro de digitação em um overlay não deve criar uma configuração nova sem aviso.
  • Manter as linhas de comentário e as linhas em branco do arquivo base: ativado por padrão. Desative para um arquivo resolvido compacto, sem comentários. Comentários inline presos à linha de uma chave são mantidos de qualquer forma.
  • Comparar nomes de seção e de chave sem diferenciar maiúsculas de minúsculas: alguns parsers de INI ignoram a caixa, outros não. Ative quando seu overlay escreve [Server] e a base escreve [server] e você quer que sejam tratados como a mesma seção.
  • Estilo de atribuição para as chaves adicionadas: key = value ou key=value, para as linhas novas. As linhas existentes mantêm o espaçamento que a base já usava.

O relatório de alterações

Cada chave tocada por um overlay aparece na tabela com seu valor base, seu valor mesclado e um dos quatro veredictos:

  • Changed: o overlay substituiu um valor diferente.
  • Unchanged: o overlay definiu o valor que a base já tinha. Geralmente é sinal de que o overlay ficou desatualizado e a linha pode ser apagada.
  • Added: a chave existia apenas no overlay e foi acrescentada.
  • Ignored: a chave existia apenas no overlay e Ignorá-las estava selecionado, então ela não aparece na saída.

Os quatro veredictos são exibidos em inglês na tabela, exatamente como aqui.

E os nomes [section.subsection]?

Cabeçalhos de seção com pontos são tratados como um único nome de seção literal, com as chaves comparadas uma a uma entre os arquivos. Essa é a leitura segura para uma mesclagem, pois nada é reestruturado. Se você quiser que cabeçalhos com pontos sejam expandidos em um objeto aninhado, passe o resultado pelo Conversor de INI para JSON.

Posso mesclar mais de três arquivos?

Mescle os três primeiros, cole o resultado de volta na caixa da base e adicione o próximo overlay. Para comparar duas configurações em vez de combiná-las, a Comparação de Texto oferece um diff linha a linha.

iniconfigmergeoverlayenvironmentdeployment

Ama as ferramentas? Livre-se dos anúncios.

Um único pagamento remove todos os anúncios da sua conta, para sempre. Sem assinatura, sem rastreamento.