Server Side Includes permite que o Apache processe diretivas simples dentro de HTML, como incluir outro arquivo, exibir data ou executar recursos autorizados. A tecnologia é legada e pode estar desabilitada por segurança; para aplicações novas, templates de PHP ou geradores estáticos costumam ser melhores.
Exemplo de inclusão
<!--#include virtual="/includes/cabecalho.html" -->O servidor precisa processar o arquivo. Extensões comuns são .shtml ou .shtm, conforme configuração. Um arquivo .html normal pode ser entregue sem interpretar a diretiva.
Habilitação
Em ambientes que permitem override, o administrador pode configurar Options Includes e o handler apropriado. Em hospedagem compartilhada, não adicione diretivas por tentativa: verifique suporte do plano e evite IncludesNOEXEC quando precisa apenas de inclusões sem execução.
Diagnóstico
- se a diretiva aparece no HTML, o arquivo não está sendo processado;
- erro 500 indica diretiva não permitida ou sintaxe;
- arquivo ausente gera erro no local da inclusão;
- caminho
virtualparte da raiz da URL; - permissões e propriedade continuam aplicáveis;
- cache pode manter resultado antigo.
Segurança
Não permita execução de comandos por SSI. Evite incluir caminhos controlados por usuário e não exponha variáveis internas. Diretivas amplas em .htaccess podem reduzir segurança e desempenho.
Alternativas
- includes e templates PHP;
- template engine do framework;
- componentes do CMS;
- gerador estático em etapa de build;
- reverse proxy para composição controlada.
Desempenho, cache e SEO
Uma inclusão SSI é processada a cada requisição salvo cache posterior. Para cabeçalho e rodapé estáticos, uma etapa de build reduz trabalho do servidor. Conteúdo incluído precisa manter HTML válido, títulos coerentes, links absolutos quando necessário e as mesmas regras de cache da página principal.
Para código PHP, veja versões PHP no cPanel; para falhas, consulte Erro 500.
Recursos relacionados
Continue com materiais e serviços relacionados ao tema deste guia.
Assistente IA WGS