htaccess.html.pt-br revision c7ed811e89712261aaa4432198e331389044e1f8
c6fb85f9500350e5ce58c9a24f5d264c8a8bd6f4Automatic Updater<?xml version="1.0" encoding="ISO-8859-1"?>
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence<html xmlns="http://www.w3.org/1999/xhtml" lang="pt-br" xml:lang="pt-br"><head><!--
ec5347e2c775f027573ce5648b910361aa926c01Automatic Updater XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
4c1132f34493327abc632196f5876a89aa573687Bob Halley This file is generated from xml source: DO NOT EDIT
4c1132f34493327abc632196f5876a89aa573687Bob Halley XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<title>Tutorial do Apache: arquivos .htaccess - Servidor HTTP Apache</title>
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<link href="/images/favicon.ico" rel="shortcut icon" /></head>
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<p class="menu"><a href="/mod/">M�dulos</a> | <a href="/mod/directives.html">Diretrizes</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Gloss�rio</a> | <a href="/sitemap.html">Mapa do site</a></p>
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<p class="apache">Servidor HTTP Apache Vers�o 2.3</p>
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉<img alt="" src="/images/feather.gif" /></div>
9c3531d72aeaad6c5f01efe6a1c82023e1379e4dDavid Lawrence<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
f41f183f628a148860a6d1f0070208cddd45b0c6Bob Halley<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documenta��o</a> > <a href="../">Vers�o 2.3</a> > <a href="./">How-To / Tutoriais</a></div><div id="page-content"><div id="preamble"><h1>Tutorial do Apache: arquivos .htaccess</h1>
f41f183f628a148860a6d1f0070208cddd45b0c6Bob Halley<p><span>L�nguas Dispon�veis: </span><a href="/en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
9a2127f8335bad323451d7825119cd9f72e32464Mark Andrews<a href="/fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> |
9a2127f8335bad323451d7825119cd9f72e32464Mark Andrews<a href="/ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
9a2127f8335bad323451d7825119cd9f72e32464Mark Andrews<a href="/ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
9a2127f8335bad323451d7825119cd9f72e32464Mark Andrews<a href="/pt-br/howto/htaccess.html" title="Portugu�s (Brasil)"> pt-br </a></p>
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley<p>Arquivos <code>.htaccess</code> oferecem um meio de fazer mudan�as
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley nas configura��es por-diret�rio.</p>
51917258dbb23cfe6069ae1cf2b7fc5aefc1e0c2Bob Halley<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#related">Arquivos .htaccess </a></li>
c6b3c1984caa362359862e063e7b70dfb306db7eMark Andrews<li><img alt="" src="/images/down.gif" /> <a href="#what">O que eles s�o/Como us�-los</a></li>
155a0ce6e3c9cef51b63789c34d83d9143ce01fdMark Andrews<li><img alt="" src="/images/down.gif" /> <a href="#when">Quando (n�o) usar arquivos .htaccess</a></li>
494576ce20cfd98d74955698cf8f7b37dce2f740Mark Andrews<li><img alt="" src="/images/down.gif" /> <a href="#how">Como as diretrizes s�o aplicadas</a></li>
494576ce20cfd98d74955698cf8f7b37dce2f740Mark Andrews<li><img alt="" src="/images/down.gif" /> <a href="#auth">Exemplo de Autentica��o</a></li>
6d5dcd0dc9bdbd679282b1ffc47987d24c3a1346Bob Halley<li><img alt="" src="/images/down.gif" /> <a href="#ssi">Exemplo de Server Side Includes</a></li>
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉<li><img alt="" src="/images/down.gif" /> <a href="#cgi">Exemplo de CGI</a></li>
155a0ce6e3c9cef51b63789c34d83d9143ce01fdMark Andrews<li><img alt="" src="/images/down.gif" /> <a href="#troubleshoot">Resolvendo Problemas</a></li>
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
b6d52ee5bea1b9d9074698e693b49ce96edff47bMark Andrews<h2><a name="related" id="related">Arquivos .htaccess </a></h2>
b6d52ee5bea1b9d9074698e693b49ce96edff47bMark Andrews <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_cgi.html">mod_cgi</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></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#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/core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="/mod/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/core.html#require">Require</a></code></li></ul></td></tr></table>
b6d52ee5bea1b9d9074698e693b49ce96edff47bMark Andrews</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
c45abd11bb68005d8a5c56c14b16f4184c3e057dMichael Graff<h2><a name="what" id="what">O que eles s�o/Como us�-los</a></h2>
feb08cecf318bba330437cfcb725f48d999804d8James Brister <p>Os arquivos <code>.htaccess</code> (ou "arquivos de
289ae548d52bc8f982d9823af64cafda7bd92232Mark Andrews configura��o distribu�da") oferecem um meio de fazer mudan�as nas
289ae548d52bc8f982d9823af64cafda7bd92232Mark Andrews configura��es por-diret�rio. Um arquivo, contendo uma ou mais
fb827ed6df9a473770fb69a75a455b4ad0d14f52Mark Andrews diretrizes de configura��es, � colocado em um diret�rio
494576ce20cfd98d74955698cf8f7b37dce2f740Mark Andrews em particular, e as diretrizes se aplicam para aquele diret�rio e todos
494576ce20cfd98d74955698cf8f7b37dce2f740Mark Andrews os seu subdiret�rios subseq�entes.</p>
d0eb2cc33c5db3366a16b1cb0abcca6ec7c8ee3cTatuya JINMEI 神明達哉 <p>Se voc� quiser renomear o seu arquivo <code>.htaccess</code>
6017f424ee3c02d7f22132c77576ea38542fa949Andreas Gustafsson para outro nome, voc� deve usar a diretriz <code class="directive"><a href="/mod/core.html#accessfilename">AccessFileName</a></code>. Por exemplo, se voc�
911ed0d3bee586b3bec42cb6c376d5cc6c0e1e24Brian Wellington prefere que o arquivo se chame <code>.config</code>, ent�o voc�
c7e266b7e5675e12d1ca3cc929f24b3e86d41f8eEvan Hunt pode adicionar a seguinte linha ao seu arquivo de configura��o
cfb1587eb9a6dc6d1d36ea0344e1b20068b81e88Evan Hunt do servidor:</p>
cfb1587eb9a6dc6d1d36ea0344e1b20068b81e88Evan Hunt AccessFileName .config
cfb1587eb9a6dc6d1d36ea0344e1b20068b81e88Evan Hunt <p>No geral, arquivos <code>.htaccess</code> usam a mesma sintaxe
cfb1587eb9a6dc6d1d36ea0344e1b20068b81e88Evan Hunt que os <a href="/configuring.html#syntax">arquivos de
ce1f5b8d0ae5936fd187c1f414ff12a7e3b0aa37Andreas Gustafsson configura��o principal</a>. O que voc� pode colocar nesses
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉 arquivos � determinado pele diretriz <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code>. Essa diretriz especifica,
5c6762838c9e423753723ec2a963164e3d66ac32Mark Andrews em categorias, quais diretrizes ser�o aceitas caso sejam
5c6762838c9e423753723ec2a963164e3d66ac32Mark Andrews encontradas em um arquivo <code>.htaccess</code>. Se uma diretriz
5c6762838c9e423753723ec2a963164e3d66ac32Mark Andrews for permitida em um arquivo <code>.htaccess</code>, a documenta��o
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley para essa diretriz ir� conter uma se��o <em>Override</em>,
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence especificando que valor precisa estar em <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> para que esta diretriz
289ae548d52bc8f982d9823af64cafda7bd92232Mark Andrews seja permitida.</p>
494576ce20cfd98d74955698cf8f7b37dce2f740Mark Andrews <p>Por exemplo, se voc� procurar na documenta��o pela diretriz
494576ce20cfd98d74955698cf8f7b37dce2f740Mark Andrews <code class="directive"><a href="/mod/core.html#adddefaultcharset">AddDefaultCharset</a></code>, voc�
494576ce20cfd98d74955698cf8f7b37dce2f740Mark Andrews achar� que ela � permitida nos arquivos <code>.htaccess</code>.
494576ce20cfd98d74955698cf8f7b37dce2f740Mark Andrews (Veja a linha Contexto no sum�rio das diretivas.) A
494576ce20cfd98d74955698cf8f7b37dce2f740Mark Andrews linha <a href="/mod/directive-dict.html#Context">Override</a> l�
d0eb2cc33c5db3366a16b1cb0abcca6ec7c8ee3cTatuya JINMEI 神明達哉 <code>FileInfo</code>. Ent�o, voc� deve ao menos ter
6017f424ee3c02d7f22132c77576ea38542fa949Andreas Gustafsson <code>AllowOverride FileInfo</code> para que essa diretriz seja
911ed0d3bee586b3bec42cb6c376d5cc6c0e1e24Brian Wellington aceita nos arquivos <code>.htaccess</code>.</p>
6098d364b690cb9dabf96e9664c4689c8559bd2eMark Andrews <td><a href="/mod/directive-dict.html#Context">Contexto:</a></td>
28b863e609ff2d97b78663b46894494cfa2ea411Mark Andrews <td>configura��o do servidor, hospedeiros virtuais, diret�rio, .htaccess</td>
03e200df5dc283f24a6a349f0b31d3eab26da893Mark Andrews <td><a href="/mod/directive-dict.html#Override">Override:</a></td>
4fd3e3482c7e4ce01e2cf28f13e0152c8e50d746Mark Andrews <p>Se voc� estiver incerto se uma diretriz em particular �
494576ce20cfd98d74955698cf8f7b37dce2f740Mark Andrews aceita em um arquivo <code>.htaccess</code>, procure na
4fd3e3482c7e4ce01e2cf28f13e0152c8e50d746Mark Andrews documenta��o por essa diretriz, e verifique a linha de
4fd3e3482c7e4ce01e2cf28f13e0152c8e50d746Mark Andrews Contexto por ".htaccess".</p> </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
d2b5fe92a4755ce67f2dd6050955782b4fd6b3f3Mark Andrews<h2><a name="when" id="when">Quando (n�o) usar arquivos .htaccess</a></h2>
d2b5fe92a4755ce67f2dd6050955782b4fd6b3f3Mark Andrews <p>No geral, voc� nunca deve usar arquivos <code>.htaccess</code>
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley a n�o ser que voc� n�o tenha acesso ao arquivo de configura��o
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley principal do servidor. Existe, por exemplo, um erro de concep��o
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley que dita que a autentica��o de usu�rios sempre deve
74cb99072c4b0ebd2ccafcfa284288fa760f7a1aMark Andrews ser feita usando os arquivos <code>.htaccess</code>. Esse
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley simplesmente n�o � o caso. Voc� pode usar as configura��es de
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley autentica��o de usu�rio no arquivo de configura��o principal do
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley servidor, e isso �, de fato, a maneira mais adequada de se fazer
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley as coisas.</p>
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley <p>Arquivos <code>.htaccess</code> devem ser usados em casos onde
193738b819e3c699f9edd18864a6810fcfcec855Andreas Gustafsson os provedores de conte�do do site precisem fazer mudan�as na
fd35453765c6494d077edca44f4d998af5fd4cfaDavid Lawrence configura��o do servidor por-diret�rio, mas n�o tem
fd35453765c6494d077edca44f4d998af5fd4cfaDavid Lawrence acesso <em>root</em> ao sistema do servidor. Caso o administrador do
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley servidor n�o esteja disposto a fazer mudan�as freq�entes nas
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley configura��es do servidor, � desej�vel permitir que os
74cb99072c4b0ebd2ccafcfa284288fa760f7a1aMark Andrews usu�rios possam fazer essas mudan�as atrav�s de arquivos
9f7d51ee3290e2a064d71016a6bd555b47134a7cMark Andrews <code>.htaccess</code> eles mesmos. Isso � particularmente
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley verdade, por exemplo, em casos onde provedores est�o fornecendo
881702c9c0079cd48a45054fd90d043f3a8b7e11Mark Andrews m�ltiplos sites para usu�rios em apenas uma m�quina, e querem que
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley seus usu�rios possam alterar suas configura��es.</p>
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley <p>No entanto, de modo geral, o uso de arquivos <code>.htaccess</code>
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley deve ser evitado quando poss�vel. Quaisquer configura��es
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley que voc� considerar acrescentar em um arquivo <code>.htaccess</code>, podem
922e6a3c2ac4ef900dd9dc99f0cc137f18372583Andreas Gustafsson ser efetivamente colocadas em uma se��o <code class="directive"><a href="/mod/core.html#directory"><Directory></a></code> no arquivo principal de
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley configura��o de seu servidor.</p>
74cb99072c4b0ebd2ccafcfa284288fa760f7a1aMark Andrews <p>Existem duas raz�es principais para evitar o uso de arquivos
fd35453765c6494d077edca44f4d998af5fd4cfaDavid Lawrence <p>A primeira delas � a performance. Quando <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> � configurado para
c8a42d6d81ff2fd9ad7fac94d4b85323554493c0Bob Halley permitir o uso de arquivos <code>.htaccess</code>, o Apache procura
4fd3e3482c7e4ce01e2cf28f13e0152c8e50d746Mark Andrews em todos diret�rios por arquivos <code>.htaccess</code>.
5d51e67c3b4f35c1be742574aacc1d88fe6ed444Mark Andrews Logo, permitir arquivos <code>.htaccess</code> causa um impacto na
6ef838d427c1ea858d2f09194a369134babf8b98Mark Andrews performance, mesmo sem voc� us�-los de fato! Al�m disso,
6ef838d427c1ea858d2f09194a369134babf8b98Mark Andrews o arquivo <code>.htaccess</code> � carregado toda vez que um documento
6ef838d427c1ea858d2f09194a369134babf8b98Mark Andrews � requerido.</p>
6d831cd0baf7dd2c133f7f9cbf295f3d80cf63a7David Lawrence <p>Al�m disso, note que o Apache precisa procurar pelos arquivos
6d831cd0baf7dd2c133f7f9cbf295f3d80cf63a7David Lawrence <code>.htaccess</code> em todos os diret�rios superiores, para ter
dac2799ea19735503a4d27f517d821aea210e594Andreas Gustafsson o complemento total de todas as diretivas que devem ser
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley aplicadas. (Veja a se��o <a href="#how">como as diretrizes s�o
5d51e67c3b4f35c1be742574aacc1d88fe6ed444Mark Andrews aplicadas</a>.) Ent�o, se um arquivo de um diret�rio
6d7585b3e948dd31bf78321d83ac0e024f44a71bMark Andrews <code>/www/htdocs/example</code> � requerido, o Apache precisa
6d5dcd0dc9bdbd679282b1ffc47987d24c3a1346Bob Halley procurar pelos seguintes arquivos:</p>
6d5dcd0dc9bdbd679282b1ffc47987d24c3a1346Bob Halley /.htaccess<br />
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley <p>Assim, para cada acesso de arquivo fora desse diret�rio,
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley existem 4 acessos ao sistema de arquivos adicionais, mesmo
4fd3e3482c7e4ce01e2cf28f13e0152c8e50d746Mark Andrews que nenhum desses arquivos estejam presentes. (Note que esse
5d51e67c3b4f35c1be742574aacc1d88fe6ed444Mark Andrews s� ser� o caso se os arquivos <code>.htaccess</code>
5d51e67c3b4f35c1be742574aacc1d88fe6ed444Mark Andrews normalmente n�o � o verdade.)</p>
118394ef2ec7cef253c55359a3d70d202ddc2fa0Mark Andrews <p>A segunda considera��o � relativa � seguran�a.
118394ef2ec7cef253c55359a3d70d202ddc2fa0Mark Andrews Voc� est� permitindo que os usu�rios modifiquem as
bb556a9bf3a15c7160fa4f1b71773ce12b1bedf6Bob Halley configura��es do servidor, o que pode resultar em mudan�as
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley que podem fugir ao seu controle. Considere com cuidado se voc� quer
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley ou n�o dar aos seus usu�rios esses privil�gios. Note tamb�m
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley que dar aos usu�rios menos privil�gios que eles precisam, acarreta em
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley pedidos de suporte t�cnico adicionais. Tenha certeza que voc� comunicou
fe37278859bce157001cca14cdfa3a761b0d5012Mark Andrews aos usu�rios que n�vel de privil�gios voc� os deu.
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley Especificar exatamente o que voc� configurou na diretriz <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code>, e direcion�-los para a
494576ce20cfd98d74955698cf8f7b37dce2f740Mark Andrews documenta��o relevante, ir� poup�-lo de muita confus�o
289ae548d52bc8f982d9823af64cafda7bd92232Mark Andrews <p>Perceba que � exatamente equivalente colocar o arquivo
desabilitado, ajustando a diretriz <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> para <code>none</code>:</p>
permitir o uso da diretriz "<code class="directive"><a href="/mod/core.html#options">Options</a></code>" nos arquivos
diretrizes de senha em uma se��o <code class="directive"><a href="/mod/core.html#directory"><Directory></a></code>, no seu arquivo principal de
<p>Mais comumente, o problema � que a diretriz <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> n�o est� habilitada
<p><span>L�nguas Dispon�veis: </span><a href="/en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </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> |
<p class="apache">Copyright 2010 The Apache Software Foundation.<br />Licenciado sob a <a href="http://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/directives.html">Diretrizes</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Gloss�rio</a> | <a href="/sitemap.html">Mapa do site</a></p></div>