File: /opt/bitnami/apache/manual/howto/htaccess.html.pt-br.utf8
<!DOCTYPE html SYSTEM "about:legacy-compat">
<html lang="pt-br"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="width=device-width, initial-scale=1" name="viewport">
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Tutorial do Servidor HTTP Apache: arquivos .htaccess - Servidor HTTP Apache Versão 2.4</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/quickreference.html">Diretivas</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">Perguntas Frequentes</a> | <a href="../glossary.html">Glossário</a> | <a href="../sitemap.html">Mapa do Site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Relate um problema</a></p>
<p class="apache">Servidor HTTP Apache Versão 2.4</p>
<img alt="" src="../images/feather.png"></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif"></a></div>
<div id="path">
<a href="https://www.apache.org/">Apache</a> > <a href="https://httpd.apache.org/">Servidor HTTP</a> > <a href="https://httpd.apache.org/docs/">Documentação</a> > <a href="../">Versão 2.4</a> > <a href="./">Como Fazer / Tutoriais</a></div><div id="page-content"><div id="preamble"><h1>Tutorial do Servidor HTTP Apache: arquivos .htaccess</h1>
<button aria-label="Toggle language list" class="lang-toggle"><svg xmlns="http://www.w3.org/2000/svg" stroke-width="2" stroke="currentColor" fill="none" viewBox="0 0 24 24" height="16" width="16"><circle r="10" cy="12" cx="12"/><line y2="12" x2="22" y1="12" x1="2"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg></button>
<div class="toplang">
<p><span>Línguas Disponíveis: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/htaccess.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../pt-br/howto/htaccess.html" title="Português (Brasil)"> pt-br </a></p>
</div>
<p>Arquivos <code>.htaccess</code> oferecem um meio de fazer alterações
nas configurações por diretório, sem modificar diretamente os arquivos
de configuração principais do servidor.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif"> <a href="#related">Arquivos .htaccess </a></li>
<li><img alt="" src="../images/down.gif"> <a href="#what">O que eles são / Como usá-los</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#when">Quando (não) usar arquivos .htaccess</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#how">Como as diretivas são aplicadas</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#auth">Exemplo de Autenticação</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#ssi">Exemplo de Server Side Includes</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#rewrite">Regras de reescrita em arquivos .htaccess</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#cgi">Exemplo de CGI</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#troubleshoot">Resolvendo Problemas</a></li>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="related">Arquivos .htaccess <a title="Link permanente" href="#related" class="permalink">¶</a></h2>
<table class="related"><tr><th>Módulos Relacionados</th><th>Diretrizes Relacionadas</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li><li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li><li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code></li><li><code class="module"><a href="../mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li><li><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverridelist">AllowOverrideList</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="what">O que eles são / Como usá-los <a title="Link permanente" href="#what" class="permalink">¶</a></h2>
<p>Os arquivos <code>.htaccess</code> (ou "arquivos de configuração distribuídos")
oferecem um meio de fazer alterações nas configurações por diretório. Um
arquivo, contendo uma ou mais diretivas de configurações, é colocado em um
diretório em particular e as diretivas se aplicam a este diretório e a
todos os seus subdiretórios.</p>
<div class="note"><h3>Observação:</h3>
<p>Se o nome do arquivo precisar ser diferente de <code>.htaccess</code>,
ele pode ser alterado através da diretiva <code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code>. Por exemplo,
se a preferência for chamar o arquivo de <code>.config</code>, pode
ser adicionada a seguinte linha ao arquivo de configuração do servidor:</p>
<pre class="prettyprint lang-config">AccessFileName ".config"</pre>
</div>
<p>Diretivas nos arquivos <code>.htaccess</code> usam a mesma sintaxe
que os <a href="../configuring.html#syntax">arquivos principais
de configuração</a>. O que pode ser colocado nesses arquivos é determinado pelas
diretivas <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> E
<code class="directive"><a href="../mod/core.html#allowoverridelist">AllowOverrideList</a></code>.
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> especifica, em
categorias, quais diretivas serão honradas caso sejam encontradas em um
arquivo <code>.htaccess</code>, enquanto que <code class="directive"><a href="../mod/core.html#allowoverridelist">AllowOverrideList</a></code> nomeia diretivas
individuais a serem permitidas (consulte <a href="#when">abaixo</a>). Se uma diretiva
for permitida, a documentação para essa diretiva conterá uma seção Override,
especificando que valor precisa estar em <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> para que essa diretiva
seja permitida.</p>
<div class="note">O valor padrão de <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> é <code>None</code>.
Isto significa que arquivos <code>.htaccess</code> são completamente ignorados
a menos que sejam explicitamente habilitados para um diretório.</div>
<p>Por exemplo, ao procurar na documentação pela diretiva <code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code>,
pode-se notar que ela é permitida nos arquivos <code>.htaccess</code>.
(Veja a linha Contexto no sumário das diretivas.) A
linha <a href="../mod/directive-dict.html#Context">Override</a> apresenta
<code>FileInfo</code>. Assim, deve-se ter pelo menos
<code>AllowOverride FileInfo</code> para que essa diretiva seja
honrada nos arquivos <code>.htaccess</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="when">Quando (não) usar arquivos .htaccess <a title="Link permanente" href="#when" class="permalink">¶</a></h2>
<p>Se for possível o acesso ao arquivo de principal de configuração do servidor, todas
as configurações devem ser colocadas lá em vez de inseri-las em arquivos
<code>.htaccess</code>. Isto inclui autenticação de usuários,
regras do <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> e qualquer outra coisa que você tenha
tentação de colocar no <code>.htaccess</code>. Diretivas na configuração
principal são carregadas assim que o servidor inicia, e não a cada
requisição, e o <code>mod_rewrite</code> em particular funciona melhor
no contexto de configuração do servidor.</p>
<p>Os arquivos <code>.htaccess</code> devem ser usados nos casos em que os
provedores de conteúdo precisam fazer alterações de configuração no servidor
por diretório, mas não têm acesso "root" ao sistema do servidor.
Isto é comum com ambientes de hospedagem gerenciados, hospedagem baseada
em painel de controle (como cPanel ou Plesk), e sistemas de gerenciamento de conteúdo onde
a aplicação envia um arquivo <code>.htaccess</code> como parte de sua
distribuição. Caso o administrador do servidor não esteja disposto a fazer
alterações de configuração frequentes, pode ser desejável permitir que
usuários individuais façam essas alterações em arquivos <code>.htaccess</code>
por conta própria.</p>
<p>Existem dois motivos principais para preferir o arquivo principal de configuração
no lugar do <code>.htaccess</code>: desempenho e segurança.</p>
<p>Desempenho: Quando a diretiva <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
está configurada para permitir o uso de arquivos <code>.htaccess</code>, o httpd
procurará em todos os diretórios por arquivos <code>.htaccess</code>. Portanto,
permitir arquivos <code>.htaccess</code> causa uma queda de desempenho,
independentemente de serem realmente usados ou não! Além disso, o
arquivo <code>.htaccess</code> é carregado sempre que um documento é
solicitado.</p>
<p>Observe ainda que o httpd precisa procurar arquivos <code>.htaccess</code>
em todos os diretórios de nível superior, a fim de ter um conjunto completo de
diretivas que ele deve aplicar. (Consulte a seção sobre <a href="#how">como
as diretivas são aplicadas</a>.) Assim, se um arquivo for solicitado de um
diretório <code>/www/htdocs/example</code>, o httpd precisa procurar os
seguintes arquivos:</p>
<pre class="prettyprint lang-config">/.htaccess
/www/.htaccess
/www/htdocs/.htaccess
/www/htdocs/example/.htaccess</pre>
<p>Assim, para cada acesso a um arquivo fora desse diretório, há 4
acessos adicionais ao sistema de arquivos, mesmo que nenhum desses arquivos esteja
presente. (Observe que isso só ocorreria se
os arquivos <code>.htaccess</code> estivessem habilitados para o diretório <code>/</code>, o que
normalmente não acontece.)</p>
<p>Segurança: Você está permitindo
que usuários modifiquem a configuração do servidor, o que pode resultar em alterações sobre
as quais você não tem controle.Considere cuidadosamente se deseja conceder
esse privilégio aos usuários. Observe também que conceder aos usuários menos
privilégios do que o necessário levará a solicitações adicionais de suporte
técnico. Certifique-se de informar claramente aos usuários qual o nível de
privilégios que foi condedido a eles. Especificar exatamente o valor definido para
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> e direcioná-los
para a documentação relevante evitará muita confusão
posteriormente.</p>
<p>Se for necessário conceder acesso ao <code>.htaccess</code> porém limitando
a um conjunto específico de diretivas em vez de categorias inteiras, use a
diretiva <code class="directive"><a href="../mod/core.html#allowoverridelist">AllowOverrideList</a></code>. Isso
permite nomear diretivas individuais que são permitidas, fornecendo
um controle mais fino que a <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> sozinha:</p>
<pre class="prettyprint lang-config"># Permite somente diretivas específicas, e não categorias inteiras
AllowOverride None
AllowOverrideList Redirect RedirectMatch RewriteEngine RewriteRule RewriteCond</pre>
<p>Com esta configuração, qualquer diretiva que não esteja explicitamente listada
causará um erro de servidor se encontrada em um arquivo <code>.htaccess</code>.
Isto é um meio termo útil entre o acesso total e nenhum
acesso.</p>
<p>Observe que é completamente equivalente colocar um arquivo <code>.htaccess</code>
em um diretório <code>/www/htdocs/example</code> contendo uma
diretiva, e colocar essa mesma diretiva em uma seção Directory
<code><Directory "/www/htdocs/example"></code> na configuração principal do
servidor:</p>
<p>Arquivo <code>.htaccess</code> em <code>/www/htdocs/example</code>:</p>
<div class="example"><h3>Conteúdo do arquivo .htaccess em
<code>/www/htdocs/example</code></h3><pre class="prettyprint lang-config">AddType text/example ".exm"</pre>
</div>
<div class="example"><h3>Seção do arquivo <code>httpd.conf</code>
</h3><pre class="prettyprint lang-config"><Directory "/www/htdocs/example">
AddType text/example ".exm"
</Directory></pre>
</div>
<p>O uso de arquivos <code>.htaccess</code> pode ser completamente desativado
definindo a diretiva <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
como <code>none</code>:</p>
<pre class="prettyprint lang-config">AllowOverride None</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="how">Como as diretivas são aplicadas <a title="Link permanente" href="#how" class="permalink">¶</a></h2>
<p>As diretivas de configuração encontradas em um arquivo <code>.htaccess</code>
são aplicadas ao diretório em que o arquivo <code>.htaccess</code>
está localizado e a todos os seus subdiretórios. No entanto, é importante
lembrar também que pode haver arquivos <code>.htaccess</code>
em diretórios acima na árvore. As diretivas são aplicadas na ordem em que
são encontradas. Portanto, um arquivo <code>.htaccess</code> em um determinado
diretório pode sobrescrever diretivas encontradas em arquivos <code>.htaccess</code>
localizados acima na árvore de diretórios. E estes, por sua vez, podem ter
sobrescrito diretivas encontradas ainda acima na árvore, ou no próprio arquivo de
configuração principal do servidor.</p>
<p>Exemplo:</p>
<p>No diretório <code>/www/htdocs/example1</code>, considere
um arquivo <code>.htaccess</code> contendo o seguinte:</p>
<pre class="prettyprint lang-config">Options +ExecCGI</pre>
<p>(Observação: "<code>AllowOverride Options</code>" precisa estar em vigor
para permitir o uso da diretiva "<code class="directive"><a href="../mod/core.html#options">Options</a></code>" em
arquivos <code>.htaccess</code>.)</p>
<p>No diretório <code>/www/htdocs/example1/example2</code>, considere
um arquivo <code>.htaccess</code> contendo:</p>
<pre class="prettyprint lang-config">Options Includes</pre>
<p>Devido a este segundo arquivo <code>.htaccess</code>, no diretório
<code>/www/htdocs/example1/example2</code>, a execução de CGI não é
permitida, pois apenas <code>Options Includes</code> está em vigor, o que
sobrescreve completamente qualquer configuração anterior que possa ter estado
em vigor.</p>
<h3 id="merge">Mesclagem do .htaccess com os arquivos principais
de configuração</h3>
<p>Conforme discutido na documentação sobre <a href="../sections.html">Seções de Configuração</a>,
os arquivos <code>.htaccess</code> podem sobrescrever as seções <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> para
o diretório correspondente, mas serão sobrescritos por outros tipos
de seções de configuração dos arquivos de configuração principais.
Esse fato pode ser usado para impor certas configurações, mesmo na
presença de uma configuração <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> permissiva. Por exemplo, para
impedir a execução de scripts, permitindo que qualquer outra configuração seja feita em
<code>.htaccess</code>, pode ser usado:</p>
<pre class="prettyprint lang-config"><Directory "/www/htdocs">
AllowOverride All
</Directory>
<Location "/">
Options +IncludesNoExec -ExecCGI
</Location></pre>
<div class="note">Este exemplo pressupõe que <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> seja <code>/www/htdocs</code>.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="auth">Exemplo de Autenticação <a title="Link permanente" href="#auth" class="permalink">¶</a></h2>
<p>Como em qualquer caso de uso de <code>.htaccess</code>, inserir estas diretivas em
um bloco <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> é
preferido quando se tem acesso à configuração principal (consulte
<a href="#when">above</a>). O exemplo s seguir mostra o método
<code>.htaccess</code>:</p>
<p>Conteúdo de <code>.htaccess</code>:</p>
<pre class="prettyprint lang-config">AuthType Basic
AuthName "Senha Requerida"
AuthUserFile "/www/senhas/arquivo.senhas"
AuthGroupFile "/www/senhas/arquivo.grupos"
Require group admins</pre>
<p>Observe que <code>AllowOverride AuthConfig</code> deve estar em vigor
para que essas diretivas tenham algum efeito.</p>
<p>Consulte o <a href="auth.html">tutorial de autenticação</a> para uma
discussão mais completa sobre autenticação e autorização.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="ssi">Exemplo de Server Side Includes <a title="Link permanente" href="#ssi" class="permalink">¶</a></h2>
<p>Outro uso comum de arquivos <code>.htaccess</code> é habilitar
inclusões do lado do servidor para um diretório específico. Isso pode ser feito com
as seguintes diretivas de configuração, colocadas em um
arquivo <code>.htaccess</code> no diretório desejado:</p>
<pre class="prettyprint lang-config">Options +Includes
AddType text/html shtml
AddHandler server-parsed shtml</pre>
<p>Observe que <code>AllowOverride Options</code> e <code>AllowOverride
FileInfo</code> devem estar ambos em vigor para que essas diretivas tenham algum
efeito.</p>
<p>Consulte o <a href="ssi.html">tutorial SSI</a> para uma discussão mais
completa sobre includes do lado do servidor.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="rewrite">Regras de reescrita em arquivos .htaccess <a title="Link permanente" href="#rewrite" class="permalink">¶</a></h2>
<p>Ao usar <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> em
arquivos .htaccess, esteja ciente de que o contexto por diretório
muda um pouco as coisas. Em particular, as regras são consideradas relativas
ao diretório atual, em vez de serem o URI solicitado original.
Considere os seguintes exemplos:</p>
<pre class="prettyprint lang-config"># No arquivo httpd.conf
RewriteRule "^/imagens/(.+)\.jpg" "/imagens/$1.png"
# No arquivo .htaccess do diretório raiz
RewriteRule "^imagens/(.+)\.jpg" "imagens/$1.png"
# No arquivo .htaccess do diretório imagens/
RewriteRule "^(.+)\.jpg" "$1.png"</pre>
<p>Em um arquivo <code>.htaccess</code> no diretório de documentos, a barra inicial
é removida do valor fornecido para <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>, e no subdiretório
<code>imagens</code>, <code>/imagens/</code> é removido
dele. Portanto, a expressão regular precisa omitir essa parte
também.</p>
<p>Observe também que no contexto do <code>.htaccess</code>, expressões regulares são
recompiladas a cada requisição, enquanto que na configuração principal do servidor elas
são compiladas apenas uma vez e armazenadas em cache.</p>
<p>Consulte a <a href="../rewrite/">documentação do mod_rewrite</a> para
obter mais detalhes sobre como usar o <code>mod_rewrite</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="cgi">Exemplo de CGI <a title="Link permanente" href="#cgi" class="permalink">¶</a></h2>
<div class="note">Scripts CGI são um mecanismo legado para conteúdo dinâmico. Para novos
desenvolvimentos, considere o uso de <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code> com um
servidor de aplicação FastCGI ou um manipulador específico para algum framework. A
informação abaixo permanece útil para ambientes que ainda dependem de
CGI tradicional.</div>
<p>Pode ser necessário usar um arquivo <code>.htaccess</code> para permitir
a execução de programas CGI em um diretório específico. Isso pode ser
implementado com a seguinte configuração:</p>
<pre class="prettyprint lang-config">Options +ExecCGI
AddHandler cgi-script cgi pl</pre>
<p>Alternativamente, se for necessário que todos os arquivos no diretório especificado sejam
considerados programas CGI, isso pode ser feito com a seguinte
configuração:</p>
<pre class="prettyprint lang-config">Options +ExecCGI
SetHandler cgi-script</pre>
<p>Observe que <code>AllowOverride Options</code> e <code>AllowOverride
FileInfo</code> devem estar ambos em vigor para que essas diretivas tenham algum
efeito.</p>
<p>Consulte o <a href="cgi.html">tutorial CGI</a> para uma discussão mais
completa sobre programação e configuração CGI.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="troubleshoot">Resolvendo Problemas <a title="Link permanente" href="#troubleshoot" class="permalink">¶</a></h2>
<p>Quando são colocadas diretivas de configuração em um arquivo <code>.htaccess</code>
e não é obtido o efeito desejado, há uma série de
coisas que podem estar dando errado.</p>
<p>O problema mais comum é que a diretiva <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> não está
configurada de forma que suas diretivas de configuração sejam respeitadas.
Certifique-se de que não exista um <code>AllowOverride None</code> em vigor
para o escopo do arquivo em questão. Um bom teste para isso é colocar uma
palavra sem sentido no seu arquivo <code>.htaccess</code> e recarregar a
página:</p>
<pre class="prettyprint lang-config">TestMe</pre>
<p>Se um erro do servidor (HTTP 500) não
for gerado, é quase certeza que <code>AllowOverride
None</code> esteja em vigor.</p>
<p>Se, por outro lado, erros do servidor estiverem sendo gerados ao tentar
acessar documentos, verifique o registro de erros do httpd. Ele provavelmente informará
que a diretiva usada no arquivo <code>.htaccess</code> não é
permitida.</p>
<pre class="prettyprint lang-config">[Tue May 06 09:12:31.528374 2025] [core:alert] [pid 12345] [client 192.168.1.50:54321] /var/www/html/.htaccess: DirectoryIndex not allowed here</pre>
<p>Isso indicará que foi usada uma diretiva que
nunca é permitida em arquivos <code>.htaccess</code>, ou que simplesmente
não existe um <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> definido para
um nível suficiente para a diretiva usada. Consulte a
documentação dessa diretiva específica para determinar qual
é o caso.</p>
<p>Alternativamente, pode aparecer um erro de sintaxe no
uso da própria diretiva.</p>
<pre class="prettyprint lang-config">[Tue May 06 09:14:02.946218 2025] [core:alert] [pid 12345] [client 192.168.1.50:54321] /var/www/html/.htaccess: RewriteCond: bad flag delimiters</pre>
<p>Neste caso, a mensagem de erro deve ser específica para o
erro de sintaxe cometido.</p>
</div></div>
<div class="bottomlang">
<p><span>Línguas Disponíveis: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/htaccess.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../pt-br/howto/htaccess.html" title="Português (Brasil)"> pt-br </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licenciado sob a <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/quickreference.html">Diretivas</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">Perguntas Frequentes</a> | <a href="../glossary.html">Glossário</a> | <a href="../sitemap.html">Mapa do Site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Relate um problema</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
var langToggle = document.querySelector('.lang-toggle');
var topLang = document.querySelector('.toplang');
if (langToggle && topLang) {
langToggle.addEventListener('click', function() { topLang.classList.toggle('open'); });
}
var qv = document.getElementById('quickview');
if (qv) {
document.body.appendChild(qv);
var qvBtn = document.createElement('button');
qvBtn.className = 'qv-toggle';
qvBtn.setAttribute('aria-label', 'Toggle page navigation');
qvBtn.innerHTML = '☰';
document.body.appendChild(qvBtn);
qvBtn.addEventListener('click', function() {
var isOpen = qv.classList.toggle('open');
if (isOpen) {
qv.style.top = window.scrollY + 10 + 'px';
}
});
window.addEventListener('scroll', function() { qv.classList.remove('open'); });
}
//--><!]]></script>
</body></html>