Edite arquivos de configuração .INI usando interface Web

Programação PHP: Com a classe clsINI você pode gerenciar parâmetros de arquivos textos (*.INI) através do navegador Web, de forma fácil e simples.

Introdução

Arquivos .INI são arquivos textos comuns que utilizamos para guardar informações dispostas em um formato convencionado, com objetivo de serem recuperadas em um dado momento para uso pelo sistema.

A seguir, um exemplo de arquivo .INI:

config.ini:
; Exemplo de padrão/Formato do arquivo INI usado na classe clsINI 
 
[preferencia]
; Esta sessão contém as preferências html do site
bg_color = #FF0000          ; Cor de fundo - BackGround
tamanho_fonte = 12          ; Tamanho da fonte do texto 
 
[pagina]
; Esta sessão diz respeito à paginação
num_reg = 30                ; Número de registro por página
num_pag = 10                ; Número máximo de página no controle

Como funciona?

Observe que o arquivo .INI é composto por uma ou mais sessões nomeadas por uma palavra-chave entre colchetes, seguido pelos respectivos parâmetros, valores e comentários. Toda linha de texto que vem após o ponto e vírgula representa um comentário, e portanto, será ignorada.

Algo importante ainda a considerar na construção do arquivo .INI é que os nomes das sessões devem ser digitados no início da linha, não podendo haver espaços antes do colchete.

Uma vez tendo criado o arquivo .INI, no nosso caso o “config.ini”, basta instanciar a classe clsINI no arquivo PHP, que chamaremos de config.php, e fazer a chamada aos métodos de interesse, como demonstrado a seguir:

config.php

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
<?php
  # Nome do arquivo .INI onde estão os parâmetros
  $ini_file = "config.ini";
 
  # Instancia a classe clsINI e inicializa objeto 
  include_once ("clsini.php");
  $objINI = new clsINI($ini_file);
 
  # Recupera a ação a ser executada: "Salvar" ou "Adicionar"
  if (isset($_POST['action'])) $actie = $_POST['action'];
  switch ($actie) {
      case "save" :
          $objINI->edit($_POST);
          $objINI->save();
          echo "Arquivo INI atualizado.<br />";
          break;
      case "add":
          $section = $_POST['section'];
          $name = $_POST['name'];
          $value = $_POST['value'];
          set_ini_parameter($name, $value, $section); 
          echo "Parameter added.<br>";
          break;
  }
 
  # Exibe formulário HTML com sessões e parâmetros e permite EDITAR valores e comentários 
  echo $objINI->editform();
 
  # Exibe formulário HTML para ADICIONAR uma sessão, parâmetro e valor 
  echo $objINI->addform();
?>

Otimização

Se preferir, você pode melhorar o layout e design, bem como traduzir os textos para o português, já que é pouca coisa e o script é simples. Fazendo a chamada do arquivo config.php pelo Navegador Web, o código acima reproduzirá a seguinte saída:

Saída

Para tão somente exibir o conteúdo do arquivo .INI, faça:

1
2
3
4
<?php
    $ini_file = "config.ini";
    echo readfile ($ini_file); 
?>

Analise o código fonte da classe para um conhecimento mais aprofundado sobre os métodos/funções existentes. Em resumo é isto!

Total de acessos: 4488

Deixe uma resposta

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *