O que é um 'Server Side Includes - SSI ?
O SSI (Server Side Includes) é um tipo especial de comando que funciona de maneira semelhante às tags de html, e permite incluir informações ou arquivos dentro de um arquivo html já pronto. Quando o servidor interpreta um html, e chega uma linha de um comando ssi, ao invés de apresentar a linha, ele executa o comando.
O que acontece é um arquivo sendo incluso dentro de um html, que retorna uma informação.
Para que serve o SSI?
O SSI é uma forma de se dinamizar um site, com pouco esforço em termos de programação. Um exemplo prático de sua utilização, seria se você precisasse incluir em todas as páginas de seu site uma assinatura da firma ou endereço para contato.
Ao invés de incluir sempre a mesma assinatura da empresa em cada página, com o SSI basta incluir uma linha de comando que chame um arquivo com a assinatura. Se houver a necessidade de alteração da assinatura, basta alterar o arquivo chamado pelo SSI. A vantagem nesse caso se torna evidente.
Habilitando a função SSI
Para que o SSI funcione em seu site, é preciso solicitar a ativação do mesmo através de nosso formulário de suporte.
Como utilizar o SSI?
Após a ativação dessa funcionalidade, para utilizá-lo basta incluir comandos de uma linha no código fonte. Todos os comandos do SSI possuem a seguinte estrutura: <!--#comando variável="valor_da_variável" -->
Sempre deve haver um espaço depois da última aspa ou o comando não será interpretado. Para que o servidor possa reconhecer o SSI, a extensão do arquivo onde houver o comando deve ser .shtml ao invés de .html ou .htm.
Comandos do SSI
Alguns dos comandos SSI utilizam os parâmetros "file" e "virtual" para indicar o caminho de um arquivo. O parâmetro file é usado para indicar um arquivo no diretório atual, ou em um subdiretório do mesmo. O parâmetro virtual é utilizado para indicar um caminho que se inicie na raiz do servidor.
Config
Configura a mensagem de erro do ssi, altera as configurações de data e apresentação de tamanhos de arquivos, deve-se utilizar o seguinte comando:
<!--#config errmsg="mensagem de erro" -->
Data
Para se configurar a Data/Horário deve-se utilizar o seguinte comando:
<!--#config timefmt="especificação" -->
%a Nome abreviado do dia da semana, de acordo com a localidade.
%A Nome completo do dia da semana, de acordo com a localidade.
%b Nome abreviado do mês, de acordo com a localidade.
%B Nome completo do mês, de acordo com a localidade.
%c Representação preferida de data e hora para a localidade.
%d Dia do mês em forma de número decimal (variando entre 0 e 31)
%m Mês na forma de número decimal (variando de 0 a12)
%S Segundos na forma de número decimal
%Z Fuso horário, nome ou abreviação
Tamanho de Arquivo
Para se utilizar indicar o tamanho de um arquivo deve-se utilizar o seguinte comando:
<!--#config sizefmt="bytes" --> ou <!--#config sizefmt="abbrev" -->
O primeiro indica o tamanho em Bytes, e o segundo indica arrendado em Kbytes.
Echo
O comando echo inclui o valor de uma variável dentro da página. A forma do comando é:
<!--#echo var="variável" -->
Date_GMT Indica a data e hora atual de acordo com o Greenwich Mean Time
Date_Local Indica a data e hora atual de acordo com a hora local
Document_Name Retorna o nome de arquivo do documento principal
Document_URL Retorna o caminho e nome do arquivo do documento principal
Last_Modified Indica data / hora da última modificação do documento principal
O comando flastmod serve para indicar a data da última atualização de um arquivo ou parte dele. A estrutura do comando é:
<!--#flastmod file="nome_do_arquivo.shtml" -->
Fsize
O comando fsize serve para retornar o tamanho de um arquivo indicado. Ele pode ser utilizado com relação a qualquer arquivo. Sua estrutura é:
<!--#fsize file="nome_do_arquivo.shtml" -->
Include
O comando include serve para se incluir um arquivo dentro de uma página html. Ele chama o conteúdo do segundo arquivo no seu lugar no código quando é processado. Sua estrutura é:
