Iniciante Fundamentos

Arquivo .htaccess

O .htaccess é um arquivo de configuração colocado dentro de uma pasta do site. Ele permite mudar regras do Apache sem editar a configuração principal nem reiniciar o serviço. É útil quando você não tem acesso à config global (hospedagem compartilhada).

Como funciona

O Apache lê o .htaccess a cada requisição naquela pasta. As regras valem para a pasta e suas subpastas.

Habilitar

O .htaccess só funciona se AllowOverride permitir, no bloco <Directory>:

<Directory /var/www/exemplo>
    AllowOverride All
    Require all granted
</Directory>

Exemplo de .htaccess

Crie o arquivo /var/www/exemplo/.htaccess:

# Desliga a listagem de arquivos
Options -Indexes

# Página de erro personalizada
ErrorDocument 404 /erro404.html

Quando usar (e quando evitar)

  • Use quando não tiver acesso à config principal.
  • Evite em servidores próprios: ele é lido a cada requisição e deixa o Apache mais lento.
  • Prefira colocar as regras no <Directory> da config quando possível.

Testar

sudo systemctl reload apache2
curl -I http://localhost/exemplo/

Se uma regra do .htaccess estiver inválida, o Apache devolve erro 500. Verifique o ErrorLog em caso de problema.