Arquivos INI: o que são e como usá-los

Última atualização: 9 de março de 2025
  • Arquivos INI são documentos de configuração que armazenam configurações de programas e aplicativos.
  • Eles usam uma estrutura simples com seções, chaves e valores para organizar as informações.
  • Eles são comuns em configuração de software, personalização de jogos e automação de tarefas.
  • Eles podem ser lidos e escritos usando diversas linguagens de programação como Pascal, PHP e Python.
Arquivos INI

Bem-vindo à nossa jornada para desvendar o mistério do Arquivos INI! Se você já se perguntou o que são ou como usá-los de forma eficaz, você veio ao lugar certo. Esses arquivos podem parecer um enigma, mas com as informações certas, eles se tornam uma ferramenta poderosa no mundo da computação e configuração de software. Neste artigo, exploraremos em detalhes o que são arquivos INI, como eles funcionam e como você pode aproveitá-los ao máximo.

Arquivos INI: O que essas siglas significam?

Vamos começar do começo. O que isso significa INI nos arquivos INI? Essas siglas referem-se a «Inicialização» ou inicialização em espanhol. Arquivos INI são documentos de configuração amplamente utilizados no mundo da computação para armazenar configurações e opções de configuração para programas e aplicativos.

O que os arquivos INI contêm?

Os arquivos INI contêm informações importantes que permitem que programas e aplicativos funcionem corretamente. Esses arquivos podem incluir uma grande variedade de dados, como:

  • Parametros de configuracao: Os valores que determinam como um programa se comporta.
  • Rotas de acesso: Informações sobre a localização de arquivos ou recursos necessários para a operação do programa.
  • Preferências de usuário: Configurações personalizadas escolhidas pelo usuário.
  • Opções de interface: Detalhes sobre o design e a aparência da interface do usuário.

Como os arquivos INI são estruturados?

Os arquivos INI têm uma estrutura simples, mas eficaz. Eles geralmente são divididos em seções, cada uma com seu próprio conjunto de valores e configurações. Vejamos um exemplo básico:

[Sección 1]
Clave1=Valor1
Clave2=Valor2

[Sección 2]
Clave3=Valor3

Neste exemplo, temos duas seções, cada uma com suas próprias chaves e valores. Essa estrutura facilita a organização e a busca de informações no arquivo.

Arquivos INI em ação

Agora que temos uma compreensão básica do que são arquivos INI, é hora de explorar como eles são usados ​​no mundo real e como podem beneficiar você.

Configuração de software

Uma das aplicações mais comuns dos arquivos INI é a configuração de software. Muitos programas usam esses arquivos para armazenar preferências do usuário. Você já personalizou as opções de um programa e se perguntou onde elas são salvas? A resposta geralmente é um arquivo INI!

Personalização do jogo

Se você é um entusiasta de videogames, provavelmente já se deparou com os Arquivos INI. Esses arquivos são usados ​​para ajustar as configurações do jogo, desde a qualidade gráfica até as configurações de controle. Você pode personalizar sua experiência de jogo modificando esses arquivos.

Automação de tarefas

Arquivos INI também são úteis para automatizar tarefas. Os programas podem ler e modificar esses arquivos para executar ações específicas de forma programada. Isso é especialmente útil em ambientes empresariais e de administração de sistemas.

Arquivos INI na web

Os arquivos INI não se limitam a aplicativos de desktop. Na web, eles são usados ​​em tecnologias como PHP para armazenar informações de configuração. Se você trabalha com desenvolvimento web, entender como esses arquivos funcionam pode ser essencial.

Como usar arquivos INI?

Agora que você sabe o que são arquivos INI e onde eles são usados, é hora de aprender como usá-los a seu favor.

1. Identifique o arquivo INI relevante

A primeira coisa que você precisa fazer é localizar o arquivo INI do programa ou aplicativo que deseja configurar. Geralmente está localizado no diretório de instalação do software.

  Qual é a utilidade da ciência em nossa vida diária?

2. Faça cópias de segurança

Antes de fazer alterações em um arquivo INI, certifique-se de fazer uma cópia de backup do arquivo original. Isso permitirá que você restaure suas configurações anteriores caso algo dê errado.

3. Abra o arquivo INI

Use um editor de texto simples, como o Bloco de Notas do Windows, para abrir o arquivo INI. Certifique-se de que o editor não introduza nenhuma formatação adicional, como negrito ou itálico.

4. Edite com cuidado

Faça as alterações necessárias no arquivo, prestando atenção à sintaxe. Os arquivos INI diferenciam maiúsculas de minúsculas, então você precisa ser preciso.

5. Salve as alterações

Depois de fazer os ajustes, salve o arquivo INI e feche-o. Certifique-se de que o software em questão esteja fechado antes de fazer isso.

6. Teste o programa

Inicie o programa e verifique se as alterações foram aplicadas. Se tudo funcionar como esperado, você configurou com sucesso um arquivo INI!

Dicas adicionais

Aqui estão algumas dicas adicionais para aproveitar ao máximo os arquivos INI:

  • Documentação: Consulte sempre a documentação do programa ou aplicativo para entender melhor as opções disponíveis no arquivo INI.
  • comentários: Você pode adicionar comentários a um arquivo INI precedendo as linhas com o símbolo de ponto e vírgula (;). Isso ajudará você a lembrar o propósito de cada configuração.
  • Experiência: Não tenha medo de experimentar as configurações em um arquivo INI. Você pode aprender muito tentando valores diferentes e vendo como eles afetam o programa.

Exemplos de leitura e escrita em arquivos INI

Os exemplos a seguir fazem uso de um arquivo INI comum (config.ini), que é mostrado abaixo:

[BaseDatos]
Usuario=minombre
Password=unaClave

[Preferencias]
Fondo=Blanco
Color=Azul

1) Exemplo em Free Pascal

Abaixo está o código completo para ler e escrever um arquivo INI usando Free Pascal

program fileIni;

{$mode objfpc}{$H+}

uses
  {$IFDEF UNIX}{$IFDEF UseCThreads}
  cthreads,
  {$ENDIF}{$ENDIF}
  Classes
  { you can add units after this }
  , Sysutils, IniFiles;

const
  ARCHIVO_CONFIG = 'config.ini';

var
  Ini: TIniFile;
  Valor: String;

begin
  { El método Create es el constructor de la clase, que recibe como parámetro
      el nombre del archivo INI.}
  Ini := TIniFile.Create(ARCHIVO_CONFIG);

  {Para leer valores se especifica el nombre de sección y clave
    en los métodos ReadString.}
  // Leer valor de sección BaseDatos
  Valor := Ini.ReadString('BaseDatos','Usuario','');
  WriteLn('Usuario BD: ', Valor);

  // Leer valor de sección Preferencias
  Valor := Ini.ReadString('Preferencias','Fondo', '');
  WriteLn('Color de fondo', Valor);

  {Para escribir valores se indica sección y clave con WriteString
    antes de guardar con UpdateFile.}
  // Escribir valor en sección BaseDatos
  Ini.WriteString('BaseDatos','Password','NuevaClave');

  // Escribir valor en sección Preferencias
  Ini.WriteString('Preferencias', 'Color', 'Verde');

  Ini.UpdateFile;
  Ini.Free;
end.

Este código é um programa escrito em Pascal que trabalha com arquivos INI para configuração. Aqui está uma breve explicação do que ele faz:

  1. Inclui as unidades necessárias: O programa utiliza as unidades Classes, SysUtilse IniFiles, que fornecem as funções necessárias para trabalhar com arquivos INI e outros recursos.
  2. Define uma constante ARCHIVO_CONFIG que contém o nome do arquivo INI a ser usado, neste caso, "config.ini".
  3. Declarar uma variável Ini tipo TIniFile. Esta variável é usada para interagir com o arquivo INI.
  4. O programa começa criando uma instância de TIniFile chamada Ini com o construtor Create, passando o nome do arquivo INI ("config.ini") como parâmetro.
  5. Então use o método ReadString de Ini para ler valores do arquivo INI. Neste caso, são lidos dois valores: o primeiro da seção “Banco de Dados” e chave “Usuário”, e o segundo da seção “Preferências” e chave “Fundo”. Os valores lidos são armazenados na variável Valor e são exibidos no console.
  6. Então use o método WriteString de Ini para escrever valores no arquivo INI. Neste caso, uma nova senha é definida na seção “Banco de dados” e na chave “Senha”, e a cor na seção “Preferências” e na chave “Cor” é alterada para “Verde”.
  7. Então o método é chamado UpdateFile para salvar as alterações feitas no arquivo INI no disco.
  8. Por fim, a memória da instância é liberada. Ini chamando para Ini.Free.

Resumidamente, este programa serve para ler e escrever valores de configuração em um arquivo INI chamado “config.ini” em seções específicas, e então salva as alterações feitas no arquivo.

  Entrevistas baseadas em competências: ferramentas e técnicas para recrutadores

2) Exemplo em PHP

Abaixo está o código completo para ler e escrever um arquivo INI usando PHP. Inclua a classe e o exemplo de uso no mesmo script, mas você pode separá-los para seguir as práticas recomendadas de programação:

<?php

class ManejadorIni
{
    private $filename;
    private $contenido;

    public function __construct($filename)
    {
        if (!file_exists($filename)) {
            throw new Exception('El archivo no existe.');
        }

        $this->filename = $filename;
        $this->contenido = parse_ini_file($filename, true);

        if ($this->contenido === false) {
            throw new Exception('No se pudo analizar el archivo INI.');
        }
    }

    public function leer($seccion, $clave)
    {
        if (isset($this->contenido[$seccion]) && isset($this->contenido[$seccion][$clave])) {
            return $this->contenido[$seccion][$clave];
        }
        return '';
    }

    public function escribir($seccion, $clave, $valor)
    {
        $this->contenido[$seccion][$clave] = $valor;
    }

    public function guardar()
    {
        $texto = "; Archivo INI generado por ManejadorIni\n";
        
        foreach ($this->contenido as $sec => $cont) {
            $texto .= "\n[$sec]\n";
            
            foreach ($cont as $key => $val) {
                $texto .= "$key=$val\n";
            }
        }

        if (file_put_contents($this->filename, $texto) === false) {
            throw new Exception('No se pudo guardar el archivo INI.');
        }
    }

    public function __destruct()
    {
        $this->filename = null;
        $this->contenido = null;
    }
} // Aqui termina la Clase.


// Código para probar la Clase: ManejadorIni
try {
    // Iniciar el manejador para un archivo INI específico
    $manejador = new ManejadorIni('config.ini');

    // Leer valores
    $nombreUsuario = $manejador->leer('BaseDeDatos', 'usuario');
    if (empty($nombreUsuario)) {
        echo "No se pudo obtener el nombre de usuario desde el archivo INI.\n";
    }
    echo "Nombre de Usuario actual: " . $nombreUsuario . "<br>";

    // Escribir valores
    $manejador->escribir('BaseDeDatos', 'usuario', 'nuevoUsuario');

    // Guardar cambios al archivo
    $manejador->guardar();

} catch (Exception $e) {
    // Manejo de excepciones
    echo "Se ha encontrado un error: " . $e->getMessage();
}


?>

Este código PHP define uma classe chamada ManejadorIni que é usado para ler, modificar e salvar arquivos de configuração no formato INI. Aqui está a funcionalidade básica do código:

  1. A aula ManejadorIni tem propriedade privada $filename (para armazenar o nome do arquivo INI) e $contenido (para armazenar o conteúdo analisado do arquivo INI).
  2. No construtor de classe ManejadorIni, verifica se o arquivo INI especificado existe. Se não existir, uma exceção será lançada. O construtor então analisa o conteúdo do arquivo INI usando a função parse_ini_file e armazena o resultado na propriedade $contenido. Se a função de análise falhar, uma exceção também será gerada.
  3. A classe fornece três métodos principais:
    • leer($seccion, $clave): Permite que você leia um valor específico de uma seção e uma chave no arquivo INI. Se a seção e a chave existirem, retorne o valor; caso contrário, retorna uma string vazia.
    • escribir($seccion, $clave, $valor): Permite que você escreva ou modifique um valor no arquivo INI para uma determinada seção e chave. Essa modificação é feita na memória e não é salva no arquivo até que o método seja chamado. guardar().
    • guardar(): Salva as alterações feitas na memória no arquivo INI original. Navegue pelo conteúdo armazenado em $this->contenido e grava-o de volta no arquivo INI.
  4. O método __destruct() Ele é responsável por limpar as propriedades quando a instância da classe é destruída.
  5. Fora da definição de classe, um exemplo de uso é dado:
    • Uma instância é criada ManejadorIni para o arquivo 'config.ini'.
    • O valor da chave 'user' é lido da seção 'Database' do arquivo INI.
    • Se o valor estiver vazio, uma mensagem de erro será exibida.
    • O valor de 'user' é alterado para 'newUser'.
    • As alterações são salvas no arquivo INI.
  Tecnologia digital na educação

O código também lida com exceções, portanto, se ocorrerem erros durante a leitura, gravação ou salvamento do arquivo INI, eles serão detectados e uma mensagem de erro apropriada será exibida em vez de causar o aborto do programa.

NOTA: O script PHP não faz uso da sintaxe avançada do PHP 7.x, pois tenta ser compatível com o PHP 5.6 e o ​​PHP 7.

3) Exemplo em Python

Abaixo mostramos a funcionalidade de leitura e escrita no arquivo INI: config.ini usando Python:

import configparser

# Crear un objeto ConfigParser
config = configparser.ConfigParser()

# Leer el archivo INI
config.read('config.ini')

# Leer valores del archivo INI
usuario_bd = config.get('BaseDatos', 'Usuario')
password_bd = config.get('BaseDatos', 'Password')
fondo = config.get('Preferencias', 'Fondo')
color = config.get('Preferencias', 'Color')

# Mostrar los valores leídos
print('Usuario BD:', usuario_bd)
print('Password BD:', password_bd)
print('Fondo:', fondo)
print('Color:', color)

# Escribir valores en el archivo INI
config.set('BaseDatos', 'Usuario', 'nuevo_usuario')
config.set('BaseDatos', 'Password', 'NuevaClave2')
config.set('Preferencias', 'Fondo', 'Red')
config.set('Preferencias', 'Color', 'Azul')

# Guardar los cambios en el archivo INI
with open('config.ini', 'w') as configfile:
    config.write(configfile)

O programa Python usa a biblioteca configparser para ler e escrever em um arquivo INI chamado “config.ini”. Aqui está uma breve explicação do que ele faz:

  1. Importar a biblioteca configparser para trabalhar com arquivos INI.
  2. Crie um objeto ConfigParser chamado config.
  3. Leia o arquivo INI usando o método read de config.
  4. Lê os valores existentes no arquivo INI para as seções "Banco de Dados" e "Preferências" usando o método get. Em seguida, exiba esses valores no console.
  5. Atualiza os valores no arquivo INI usando o método set. Neste caso, altere o nome de usuário e a senha na seção “Banco de dados”, e o fundo e a cor na seção “Preferências”.
  6. Salvar alterações no arquivo INI usando o método write e um arquivo de saída chamado “config.ini”.

Em suma, o programa permite ler, modificar e salvar valores em um arquivo INI usando a biblioteca configparser Pitão.

Conclusão

Os arquivos INI podem parecer um mistério no começo, mas com as informações certas e um pouco de prática, você se tornará um especialista em usá-los. Esses documentos de configuração simples desempenham um papel crucial na personalização de software, otimização de jogos e automatização de tarefas. Então não tenha medo de entrar no mundo dos arquivos INI e comece a aproveitar todo o seu potencial hoje mesmo!

É importante lembrar que também existem outros tipos de arquivos de configuração chamados XML, que são usados ​​em diferentes áreas da computação, como bancos de dados, troca de informações ou configuração de aplicativos. XML é uma linguagem de marcação extensível que permite que dados sejam estruturados e armazenados em um formato legível por humanos e máquinas. Diferentemente do arquivo de configuração tradicional baseado em texto simples, o formato XML usa tags e atributos para definir a estrutura do documento.

Se você achou este guia sobre arquivos INI útil, sinta-se à vontade para compartilhá-lo com outros entusiastas de computadores e tecnologia. Juntos, podemos simplificar o quebra-cabeça dos arquivos INI e torná-los acessíveis a todos. Compartilhe o conhecimento e ajude outros a dominar esta poderosa ferramenta de configuração!