.Htaccess Mod Rewrite

Como Usar Eficazmente mod_rewrite para Carregar Arquivos Fora do DocumentRoot no Apache

Ao trabalhar com servidores web Apache, você pode se deparar com situações em que precisa servir arquivos que residem fora do diretório DocumentRoot. Isso pode ser especialmente complicado e pode levar a erros frustrantes, como “A URL solicitada não foi encontrada neste servidor.” Neste post do blog, vamos explorar como configurar corretamente o arquivo .htaccess e mod_rewrite para carregar arquivos fora do DocumentRoot.

Compreendendo o Problema

Considere a seguinte estrutura de pastas:

home/
    webroot/
    other_files/

Imagine que você tem um arquivo .htaccess no diretório webroot preenchido com este código:

RewriteEngine on
RewriteRule ^(.*)$ /home/other_files/$1

Se você tentar acessar http://example.com/file.html, pode ver um erro como:

A URL solicitada /home/other_files/file.html não foi encontrada neste servidor.

Isso indica que o Apache não sabe como servir arquivos localizados na pasta other_files, pois ela está fora do DocumentRoot definido.

A Solução

Para carregar corretamente arquivos fora do DocumentRoot usando .htaccess e mod_rewrite, você precisará fazer algumas alterações na configuração do servidor. Vamos dividir isso em etapas claras.

Etapa 1: Configurar o Servidor Apache

Para permitir que o Apache sirva arquivos do diretório other_files, você precisará adicionar um bloco de configuração nas configurações do servidor. Isso é tipicamente feito nos arquivos de configuração do Apache (não no arquivo .htaccess). Veja como:

<Directory "/home/other_files">
    Options Indexes MultiViews FollowSymLinks
    AllowOverride None
    Order deny,allow
    Deny from all
    Allow from 127.0.0.0/255.0.0.0 ::1/128
</Directory>

Explicação da Configuração:

  • Options: Controla as opções para o diretório (como habilitar indexação).
  • AllowOverride: Define quais diretivas podem ser sobrescritas pelo .htaccess.
  • Order: Especifica a ordem de controle de acesso (negar primeiro, depois permitir).
  • Deny/Allow: Define quais endereços IP têm permissão para acessar o diretório.

Etapa 2: Usar a Diretiva Alias (Opcional)

Se você não quiser configurar o Apache diretamente para expor o diretório other_files, pode criar um alias que mapeie uma URL para a localização real do arquivo. Veja como isso poderia ser feito:

Alias /doc/ "/home/other_files/"
<Directory "/home/other_files/">
    Options Indexes MultiViews FollowSymLinks
    AllowOverride None
    Order deny,allow
    Deny from all
    Allow from 127.0.0.0/255.0.0.0 ::1/128
</Directory>

Usando um Alias, você pode agora reescrever uma URL como /doc/file.html para buscar arquivos no diretório other_files.

Etapa 3: Reiniciar o Apache

Depois de fazer essas alterações na configuração do Apache, certifique-se de reiniciar o servidor para que as novas configurações entrem em vigor:

sudo service apache2 restart

Conclusão

Servir arquivos de diretórios fora do DocumentRoot no Apache é definitivamente possível e pode ser realizado com a configuração correta. Configurando adequadamente as diretivas na configuração do servidor Apache ou usando aliases, você pode garantir que suas reescritas no .htaccess funcionem de forma eficaz.

Se você continuar enfrentando problemas, verifique suas configurações e não hesite em consultar a Documentação Oficial do Apache para mais detalhes.

Seguindo estas etapas, você será capaz de utilizar o poder do mod_rewrite enquanto gerencia com sucesso as localizações de arquivos na configuração do seu servidor Apache!