htaccess.html.pt-br revision fd9abdda70912b99b24e3bf1a38f26fde908a74c
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<?xml version="1.0" encoding="ISO-8859-1"?>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<html xmlns="http://www.w3.org/1999/xhtml" lang="pt-br" xml:lang="pt-br"><head>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<!--
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg This file is generated from xml source: DO NOT EDIT
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg -->
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<title>Tutorial do Apache: arquivos .htaccess - Servidor HTTP Apache Vers�o 2.5</title>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<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" />
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<script src="/style/scripts/prettify.min.js" type="text/javascript">
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg</script>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<link href="/images/favicon.ico" rel="shortcut icon" /></head>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<body id="manual-page"><div id="page-header">
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<p class="menu"><a href="/mod/">M�dulos</a> | <a href="/mod/quickreference.html">Diretrizes</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Gloss�rio</a> | <a href="/sitemap.html">Mapa do site</a></p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<p class="apache">Servidor HTTP Apache Vers�o 2.5</p>
44f575c8cb19a7a5cd61664a7848be6bc197df02fuankg<img alt="" src="/images/feather.gif" /></div>
44f575c8cb19a7a5cd61664a7848be6bc197df02fuankg<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<div id="path">
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Servidor HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documenta��o</a> &gt; <a href="../">Vers�o 2.5</a> &gt; <a href="./">How-To / Tutoriais</a></div><div id="page-content"><div id="preamble"><h1>Tutorial do Apache: arquivos .htaccess</h1>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<div class="toplang">
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<p><span>L�nguas Dispon�veis: </span><a href="/en/howto/htaccess.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<a href="/fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Fran�ais">&nbsp;fr&nbsp;</a> |
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<a href="/ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<a href="/ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<a href="/pt-br/howto/htaccess.html" title="Portugu�s (Brasil)">&nbsp;pt-br&nbsp;</a></p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg</div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<div class="outofdate">Esta tradu��o pode estar desatualizada.
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg Confira a vers�o em Ingl�s para mudan�as recentes.</div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<p>Arquivos <code>.htaccess</code> oferecem um meio de fazer mudan�as
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg nas configura��es por-diret�rio.</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg</div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#related">Arquivos .htaccess </a></li>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<li><img alt="" src="/images/down.gif" /> <a href="#what">O que eles s�o/Como us�-los</a></li>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<li><img alt="" src="/images/down.gif" /> <a href="#when">Quando (n�o) usar arquivos .htaccess</a></li>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<li><img alt="" src="/images/down.gif" /> <a href="#how">Como as diretrizes s�o aplicadas</a></li>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<li><img alt="" src="/images/down.gif" /> <a href="#auth">Exemplo de Autentica��o</a></li>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<li><img alt="" src="/images/down.gif" /> <a href="#ssi">Exemplo de Server Side Includes</a></li>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<li><img alt="" src="/images/down.gif" /> <a href="#cgi">Exemplo de CGI</a></li>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<li><img alt="" src="/images/down.gif" /> <a href="#troubleshoot">Resolvendo Problemas</a></li>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg</ul><ul class="seealso"><li><a href="#comments_section">Coment�rios</a></li></ul></div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<div class="section">
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<h2><a name="related" id="related">Arquivos .htaccess </a></h2>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <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/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>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<div class="section">
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<h2><a name="what" id="what">O que eles s�o/Como us�-los</a></h2>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>Os arquivos <code>.htaccess</code> (ou "arquivos de
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg configura��o distribu�da") oferecem um meio de fazer mudan�as nas
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg configura��es por-diret�rio. Um arquivo, contendo uma ou mais
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg diretrizes de configura��es, � colocado em um diret�rio
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg em particular, e as diretrizes se aplicam para aquele diret�rio e todos
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg os seu subdiret�rios subseq�entes.</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <div class="note"><h3>Nota:</h3>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>Se voc� quiser renomear o seu arquivo <code>.htaccess</code>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg para outro nome, voc� deve usar a diretriz <code class="directive"><a href="/mod/core.html#accessfilename">AccessFileName</a></code>. Por exemplo, se voc�
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg prefere que o arquivo se chame <code>.config</code>, ent�o voc�
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg pode adicionar a seguinte linha ao seu arquivo de configura��o
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg do servidor:</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <div class="example"><p><code>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg AccessFileName .config
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg </code></p></div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg </div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>No geral, arquivos <code>.htaccess</code> usam a mesma sintaxe
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg que os <a href="/configuring.html#syntax">arquivos de
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg configura��o principal</a>. O que voc� pode colocar nesses
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg arquivos � determinado pele diretriz <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code>. Essa diretriz especifica,
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg em categorias, quais diretrizes ser�o aceitas caso sejam
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg encontradas em um arquivo <code>.htaccess</code>. Se uma diretriz
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg for permitida em um arquivo <code>.htaccess</code>, a documenta��o
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg para essa diretriz ir� conter uma se��o <em>Override</em>,
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg especificando que valor precisa estar em <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> para que esta diretriz
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg seja permitida.</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>Por exemplo, se voc� procurar na documenta��o pela diretriz
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <code class="directive"><a href="/mod/core.html#adddefaultcharset">AddDefaultCharset</a></code>, voc�
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg achar� que ela � permitida nos arquivos <code>.htaccess</code>.
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg (Veja a linha Contexto no sum�rio das diretivas.) A
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg linha <a href="/mod/directive-dict.html#Context">Override</a> l�
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <code>FileInfo</code>. Ent�o, voc� deve ao menos ter
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <code>AllowOverride FileInfo</code> para que essa diretriz seja
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg aceita nos arquivos <code>.htaccess</code>.</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <div class="example"><h3>Exemplo:</h3><table>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <tr>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <td><a href="/mod/directive-dict.html#Context">Contexto:</a></td>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <td>configura��o do servidor, hospedeiros virtuais, diret�rio, .htaccess</td>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg </tr>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <tr>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <td><a href="/mod/directive-dict.html#Override">Override:</a></td>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <td>FileInfo</td>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg </tr>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg </table></div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>Se voc� estiver incerto se uma diretriz em particular �
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg aceita em um arquivo <code>.htaccess</code>, procure na
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg documenta��o por essa diretriz, e verifique a linha de
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg Contexto por ".htaccess".</p> </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<div class="section">
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<h2><a name="when" id="when">Quando (n�o) usar arquivos .htaccess</a></h2>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>No geral, voc� nunca deve usar arquivos <code>.htaccess</code>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg a n�o ser que voc� n�o tenha acesso ao arquivo de configura��o
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg principal do servidor. Existe, por exemplo, um erro de concep��o
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg que dita que a autentica��o de usu�rios sempre deve
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg ser feita usando os arquivos <code>.htaccess</code>. Esse
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg simplesmente n�o � o caso. Voc� pode usar as configura��es de
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg autentica��o de usu�rio no arquivo de configura��o principal do
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg servidor, e isso �, de fato, a maneira mais adequada de se fazer
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg as coisas.</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>Arquivos <code>.htaccess</code> devem ser usados em casos onde
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg os provedores de conte�do do site precisem fazer mudan�as na
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg configura��o do servidor por-diret�rio, mas n�o tem
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg acesso <em>root</em> ao sistema do servidor. Caso o administrador do
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg servidor n�o esteja disposto a fazer mudan�as freq�entes nas
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg configura��es do servidor, � desej�vel permitir que os
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg usu�rios possam fazer essas mudan�as atrav�s de arquivos
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <code>.htaccess</code> eles mesmos. Isso � particularmente
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg verdade, por exemplo, em casos onde provedores est�o fornecendo
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg m�ltiplos sites para usu�rios em apenas uma m�quina, e querem que
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg seus usu�rios possam alterar suas configura��es.</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>No entanto, de modo geral, o uso de arquivos <code>.htaccess</code>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg deve ser evitado quando poss�vel. Quaisquer configura��es
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg que voc� considerar acrescentar em um arquivo <code>.htaccess</code>, podem
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg ser efetivamente colocadas em uma se��o <code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code> no arquivo principal de
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg configura��o de seu servidor.</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>Existem duas raz�es principais para evitar o uso de arquivos
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <code>.htaccess</code>.</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>A primeira delas � a performance. Quando <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> � configurado para
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg permitir o uso de arquivos <code>.htaccess</code>, o Apache procura
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg em todos diret�rios por arquivos <code>.htaccess</code>.
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg Logo, permitir arquivos <code>.htaccess</code> causa um impacto na
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg performance, mesmo sem voc� us�-los de fato! Al�m disso,
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg o arquivo <code>.htaccess</code> � carregado toda vez que um documento
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg � requerido.</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>Al�m disso, note que o Apache precisa procurar pelos arquivos
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <code>.htaccess</code> em todos os diret�rios superiores, para ter
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg o complemento total de todas as diretivas que devem ser
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg aplicadas. (Veja a se��o <a href="#how">como as diretrizes s�o
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg aplicadas</a>.) Ent�o, se um arquivo de um diret�rio
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <code>/www/htdocs/example</code> � requerido, o Apache precisa
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg procurar pelos seguintes arquivos:</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <div class="example"><p><code>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg /.htaccess<br />
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg /www/.htaccess<br />
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg /www/htdocs/.htaccess<br />
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg /www/htdocs/example/.htaccess
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg </code></p></div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>Assim, para cada acesso de arquivo fora desse diret�rio,
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg existem 4 acessos ao sistema de arquivos adicionais, mesmo
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg que nenhum desses arquivos estejam presentes. (Note que esse
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg s� ser� o caso se os arquivos <code>.htaccess</code>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg estiverem habilitados para <code>/</code>, o que
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg normalmente n�o � o verdade.)</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>A segunda considera��o � relativa � seguran�a.
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg Voc� est� permitindo que os usu�rios modifiquem as
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg configura��es do servidor, o que pode resultar em mudan�as
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg que podem fugir ao seu controle. Considere com cuidado se voc� quer
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg ou n�o dar aos seus usu�rios esses privil�gios. Note tamb�m
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg que dar aos usu�rios menos privil�gios que eles precisam, acarreta em
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg pedidos de suporte t�cnico adicionais. Tenha certeza que voc� comunicou
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg aos usu�rios que n�vel de privil�gios voc� os deu.
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg 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
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg documenta��o relevante, ir� poup�-lo de muita confus�o
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg depois.</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>Perceba que � exatamente equivalente colocar o arquivo
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <code>.htaccess</code> em um diret�rio
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <code>/www/htdocs/example</code> contendo uma diretriz, e
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg adicionar a mesma diretriz em uma se��o <em>Directory</em>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <code>&lt;Directory /www/htdocs/example&gt;</code> na configura��o
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg principal do seu servidor:</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>Arquivo <code>.htaccess</code> em <code>/www/htdocs/example</code>:</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <div class="example"><h3>Conte�do de um arquivo .htaccess em
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <code>/www/htdocs/example</code></h3><p><code>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg AddType text/example .exm
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg </code></p></div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <div class="example"><h3>Se��o do seu arquivo <code>httpd.conf</code></h3><p><code>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg &lt;Directory /www/htdocs/example&gt;<br />
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <span class="indent">
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg AddType text/example .exm<br />
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg </span>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg &lt;/Directory&gt;
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg </code></p></div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>No entanto, adicionando isso ao seu arquivo de configura��o do
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg servidor resultar� em uma menor perda de performance, na medida que
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg a configura��o � carregada no momento da inicializa��o do
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg servidor, ao inv�s de toda que que um arquivo � requerido.</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>O uso de arquivos <code>.htaccess</code> pode ser totalmente
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg desabilitado, ajustando a diretriz <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> para <code>none</code>:</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <div class="example"><p><code>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg AllowOverride None
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg </code></p></div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<div class="section">
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg<h2><a name="how" id="how">Como as diretrizes s�o aplicadas</a></h2>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>As diretrizes de configura��o que se encontram em um arquivo
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <code>.htaccess</code> s�o aplicadas para o diret�rio no qual o
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg arquivo <code>.htaccess</code> se encontra, e para todos os
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg subdiret�rios ali presentes. Mas, � importante lembrar tamb�m que
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg podem existir arquivos <code>.htaccess</code> no diret�rios
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg superiores. As diretrizes s�o aplicadas na ordem que s�o
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg achadas. Logo, um arquivo <code>.htaccess</code> em um diret�rio
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg em particular, pode sobrescrever as diretrizes encontradas em um
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg diret�rio acima deste em sua respectiva �rvore. Estes, por sua vez,
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg podem ter suas diretrizes sobrescritas por diretrizes ainda mais
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg acima, ou no pr�prio arquivo de configura��o principal do
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg servidor.</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>Exemplo:</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>No diret�rio <code>/www/htdocs/example1</code> n�s temos
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg um arquivo <code>.htaccess</code> contendo o seguinte:</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <div class="example"><p><code>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg Options +ExecCGI
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg </code></p></div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>(Nota: voc� deve ter "<code>AllowOverride Options</code>" para
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg permitir o uso da diretriz "<code class="directive"><a href="/mod/core.html#options">Options</a></code>" nos arquivos
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <code>.htaccess</code> .)</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <p>No diret�rio <code>/www/htdocs/example1/example2</code> n�s temos
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg um arquivo <code>.htaccess</code> contendo:</p>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg <div class="example"><p><code>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg Options Includes
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg </code></p></div>
b40d4afa431b31f3ac966f1b539e589c79a06512fuankg
<p>Devido a esse segundo arquivo <code>.htaccess</code>, no
diret�rio <code>/www/htdocs/example1/example2</code>, a execu��o
de scripts CGI n�o � permitida, pois somente <code>Options
Includes</code> est� em efeito, o que sobrescreve completamente
quaisquer outros ajustes previamente configurados.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="auth" id="auth">Exemplo de Autentica��o</a></h2>
<p>Se voc� veio diretamente � esta parte do documento para
aprender como fazer autentica��o, � importante notar uma
coisa. Existe uma concep��o errada, mas muito comum, de que �
necess�rio o uso de arquivos <code>.htaccess</code> para implementar
a autentica��o por senha. Este n�o � o caso. Colocar
diretrizes de senha em uma se��o <code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code>, no seu arquivo principal de
configura��o do servidor, � a melhor maneira de se implementar
isto, e os arquivos <code>.htaccess</code> devem ser usados apenas
se voc� n�o tem acesso ao arquivo principal de configura��o do
servidor. Veja <a href="#when">acima</a> a discuss�o sobre quando
voc� deve e quando n�o deve usar os arquivos
<code>.htaccess</code>.</p>
<p>Dito isso, se voc� ainda acredita que precisa usar um arquivo
<code>.htaccess</code>, a configura��o a seguir provavelmente
funcionar� para voc�.</p>
<p>Conte�do de um arquivo <code>.htaccess</code>:</p>
<div class="example"><p><code>
AuthType Basic<br />
AuthName "Password Required"<br />
AuthUserFile /www/passwords/password.file<br />
AuthGroupFile /www/passwords/group.file<br />
Require Group admins
</code></p></div>
<p>Note que <code>AllowOverride AuthConfig</code> precisa estar
habilitado para que estas diretrizes tenham efeito.</p>
<p>Por favor veja 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><a name="ssi" id="ssi">Exemplo de Server Side Includes</a></h2>
<p>Outro uso comum de arquivos <code>.htaccess</code> � ativar o
Server Side Includes para um diret�rio em particular. Isto pode
ser feito com as seguintes diretrizes de configura��o, colocadas em
um arquivo <code>.htaccess</code> no diret�rio desejado:</p>
<div class="example"><p><code>
Options +Includes<br />
AddType text/html shtml<br />
AddHandler server-parsed shtml
</code></p></div>
<p>Note que ambos <code>AllowOverride Options</code> e
<code>AllowOverride FileInfo</code> precisam estar habilitados
para essas diretrizes terem efeito.</p>
<p>Por favor veja o <a href="ssi.html">tutorial de SSI</a> para
uma discuss�o mais completa sobre server-side includes.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="cgi" id="cgi">Exemplo de CGI</a></h2>
<p>Finalmente, voc� pode querer que um arquivo
<code>.htaccess</code> permita a execu��o de programas CGI em um
diret�rio em particular. Isto pode ser implementado com as
seguintes configura��es:</p>
<div class="example"><p><code>
Options +ExecCGI<br />
AddHandler cgi-script cgi pl
</code></p></div>
<p>Alternativamente, se voc� desejar que todos os arquivos de um
dado diret�rio, sejam considerados programas CGI, isso pode ser
feito com a seguinte configura��o:</p>
<div class="example"><p><code>
Options +ExecCGI<br />
SetHandler cgi-script
</code></p></div>
<p>Note que ambos <code>AllowOverride Options</code> e
<code>AllowOverride FileInfo</code> precisam estar habilitados
para que essas diretrizes tenham quaisquer efeito.</p>
<p>Por favor veja o <a href="cgi.html">tutorial de CGI
tutorial</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><a name="troubleshoot" id="troubleshoot">Resolvendo Problemas</a></h2>
<p>Quando voc� adiciona diretrizes de configura��o em um arquivo
<code>.htaccess</code>, e n�o obt�m o efeito desejado, existe uma
s�rie de pontos que podem estar errados.</p>
<p>Mais comumente, o problema � que a diretriz <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> n�o est� habilitada
corretamente para que as suas diretrizes de configura��es sejam
honradas. Verifique se voc� n�o possui <code>AllowOverride
None</code> ajustado para o escopo do arquivo em quest�o. Um bom
meio de testar isso � colocar "lixo" em seu arquivo
<code>.htaccess</code> e recarreg�-lo. Se n�o for gerado nenhum
erro do servidor, certamente voc� tem <code>AllowOverride
None</code> habilitado.</p>
<p>Se, por outro lado, voc� est� obtendo erros do servidor ao
tentar acessar documentos, verifique o registro de erros do
Apache. Ele provavelmente ir� indicar que a diretriz usada em
seu arquivo <code>.htaccess</code> n�o � permitida.
Alternativamente, ele pode acusar erros de sintaxe que voc� ter�
que corrigir.</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">&nbsp;en&nbsp;</a> |
<a href="/fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Fran�ais">&nbsp;fr&nbsp;</a> |
<a href="/ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="/ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="/pt-br/howto/htaccess.html" title="Portugu�s (Brasil)">&nbsp;pt-br&nbsp;</a></p>
</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Coment�rios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/trunk/howto/htaccess.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2015 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/quickreference.html">Diretrizes</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Gloss�rio</a> | <a href="/sitemap.html">Mapa do site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>