1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="pt-br" xml:lang="pt-br"><head><!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Tutorial do Apache: arquivos .htaccess - Servidor HTTP Apache</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 href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<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>
<p class="apache">Servidor HTTP Apache Vers�o 2.3</p>
<img alt="" src="../images/feather.gif" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
<div id="path">
<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>
<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="../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 class="outofdate">Esta tradu��o pode estar desatualizada.
Confira a vers�o em Ingl�s para mudan�as recentes.</div>
<p>Arquivos <code>.htaccess</code> oferecem um meio de fazer mudan�as
nas configura��es por-diret�rio.</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 diretrizes 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="#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><a name="related" id="related">Arquivos .htaccess </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_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>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="what" id="what">O que eles s�o/Como us�-los</a></h2>
<p>Os arquivos <code>.htaccess</code> (ou "arquivos de
configura��o distribu�da") oferecem um meio de fazer mudan�as nas
configura��es por-diret�rio. Um arquivo, contendo uma ou mais
diretrizes de configura��es, � colocado em um diret�rio
em particular, e as diretrizes se aplicam para aquele diret�rio e todos
os seu subdiret�rios subseq�entes.</p>
<div class="note"><h3>Nota:</h3>
<p>Se voc� quiser renomear o seu arquivo <code>.htaccess</code>
para outro nome, voc� deve usar a diretriz <code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code>. Por exemplo, se voc�
prefere que o arquivo se chame <code>.config</code>, ent�o voc�
pode adicionar a seguinte linha ao seu arquivo de configura��o
do servidor:</p>
<div class="example"><p><code>
AccessFileName .config
</code></p></div>
</div>
<p>No geral, arquivos <code>.htaccess</code> usam a mesma sintaxe
que os <a href="../configuring.html#syntax">arquivos de
configura��o principal</a>. O que voc� pode colocar nesses
arquivos � determinado pele diretriz <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>. Essa diretriz especifica,
em categorias, quais diretrizes ser�o aceitas caso sejam
encontradas em um arquivo <code>.htaccess</code>. Se uma diretriz
for permitida em um arquivo <code>.htaccess</code>, a documenta��o
para essa diretriz ir� conter uma se��o <em>Override</em>,
especificando que valor precisa estar em <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> para que esta diretriz
seja permitida.</p>
<p>Por exemplo, se voc� procurar na documenta��o pela diretriz
<code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code>, voc�
achar� 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> l�
<code>FileInfo</code>. Ent�o, voc� deve ao menos ter
<code>AllowOverride FileInfo</code> para que essa diretriz seja
aceita nos arquivos <code>.htaccess</code>.</p>
<div class="example"><h3>Exemplo:</h3><table>
<tr>
<td><a href="../mod/directive-dict.html#Context">Contexto:</a></td>
<td>configura��o do servidor, hospedeiros virtuais, diret�rio, .htaccess</td>
</tr>
<tr>
<td><a href="../mod/directive-dict.html#Override">Override:</a></td>
<td>FileInfo</td>
</tr>
</table></div>
<p>Se voc� estiver incerto se uma diretriz em particular �
aceita em um arquivo <code>.htaccess</code>, procure na
documenta��o por essa diretriz, e verifique a linha de
Contexto por ".htaccess".</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="when" id="when">Quando (n�o) usar arquivos .htaccess</a></h2>
<p>No geral, voc� nunca deve usar arquivos <code>.htaccess</code>
a n�o ser que voc� n�o tenha acesso ao arquivo de configura��o
principal do servidor. Existe, por exemplo, um erro de concep��o
que dita que a autentica��o de usu�rios sempre deve
ser feita usando os arquivos <code>.htaccess</code>. Esse
simplesmente n�o � o caso. Voc� pode usar as configura��es de
autentica��o de usu�rio no arquivo de configura��o principal do
servidor, e isso �, de fato, a maneira mais adequada de se fazer
as coisas.</p>
<p>Arquivos <code>.htaccess</code> devem ser usados em casos onde
os provedores de conte�do do site precisem fazer mudan�as na
configura��o do servidor por-diret�rio, mas n�o tem
acesso <em>root</em> ao sistema do servidor. Caso o administrador do
servidor n�o esteja disposto a fazer mudan�as freq�entes nas
configura��es do servidor, � desej�vel permitir que os
usu�rios possam fazer essas mudan�as atrav�s de arquivos
<code>.htaccess</code> eles mesmos. Isso � particularmente
verdade, por exemplo, em casos onde provedores est�o fornecendo
m�ltiplos sites para usu�rios em apenas uma m�quina, e querem que
seus usu�rios possam alterar suas configura��es.</p>
<p>No entanto, de modo geral, o uso de arquivos <code>.htaccess</code>
deve ser evitado quando poss�vel. Quaisquer configura��es
que voc� considerar acrescentar em um arquivo <code>.htaccess</code>, podem
ser efetivamente colocadas em uma se��o <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> no arquivo principal de
configura��o de seu servidor.</p>
<p>Existem duas raz�es principais para evitar o uso de arquivos
<code>.htaccess</code>.</p>
<p>A primeira delas � a performance. Quando <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> � configurado para
permitir o uso de arquivos <code>.htaccess</code>, o Apache procura
em todos diret�rios por arquivos <code>.htaccess</code>.
Logo, permitir arquivos <code>.htaccess</code> causa um impacto na
performance, mesmo sem voc� us�-los de fato! Al�m disso,
o arquivo <code>.htaccess</code> � carregado toda vez que um documento
� requerido.</p>
<p>Al�m disso, note que o Apache precisa procurar pelos arquivos
<code>.htaccess</code> em todos os diret�rios superiores, para ter
o complemento total de todas as diretivas que devem ser
aplicadas. (Veja a se��o <a href="#how">como as diretrizes s�o
aplicadas</a>.) Ent�o, se um arquivo de um diret�rio
<code>/www/htdocs/example</code> � requerido, o Apache precisa
procurar pelos seguintes arquivos:</p>
<div class="example"><p><code>
/.htaccess<br />
/www/.htaccess<br />
/www/htdocs/.htaccess<br />
/www/htdocs/example/.htaccess
</code></p></div>
<p>Assim, para cada acesso de arquivo fora desse diret�rio,
existem 4 acessos ao sistema de arquivos adicionais, mesmo
que nenhum desses arquivos estejam presentes. (Note que esse
s� ser� o caso se os arquivos <code>.htaccess</code>
estiverem habilitados para <code>/</code>, o que
normalmente n�o � o verdade.)</p>
<p>A segunda considera��o � relativa � seguran�a.
Voc� est� permitindo que os usu�rios modifiquem as
configura��es do servidor, o que pode resultar em mudan�as
que podem fugir ao seu controle. Considere com cuidado se voc� quer
ou n�o dar aos seus usu�rios esses privil�gios. Note tamb�m
que dar aos usu�rios menos privil�gios que eles precisam, acarreta em
pedidos de suporte t�cnico adicionais. Tenha certeza que voc� comunicou
aos usu�rios que n�vel de privil�gios voc� os deu.
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
documenta��o relevante, ir� poup�-lo de muita confus�o
depois.</p>
<p>Perceba que � exatamente equivalente colocar o arquivo
<code>.htaccess</code> em um diret�rio
<code>/www/htdocs/example</code> contendo uma diretriz, e
adicionar a mesma diretriz em uma se��o <em>Directory</em>
<code><Directory /www/htdocs/example></code> na configura��o
principal do seu servidor:</p>
<p>Arquivo <code>.htaccess</code> em <code>/www/htdocs/example</code>:</p>
<div class="example"><h3>Conte�do de um arquivo .htaccess em
<code>/www/htdocs/example</code></h3><p><code>
AddType text/example .exm
</code></p></div>
<div class="example"><h3>Se��o do seu arquivo <code>httpd.conf</code></h3><p><code>
<Directory /www/htdocs/example><br />
<span class="indent">
AddType text/example .exm<br />
</span>
</Directory>
</code></p></div>
<p>No entanto, adicionando isso ao seu arquivo de configura��o do
servidor resultar� em uma menor perda de performance, na medida que
a configura��o � carregada no momento da inicializa��o do
servidor, ao inv�s de toda que que um arquivo � requerido.</p>
<p>O uso de arquivos <code>.htaccess</code> pode ser totalmente
desabilitado, ajustando a diretriz <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> para <code>none</code>:</p>
<div class="example"><p><code>
AllowOverride None
</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="how" id="how">Como as diretrizes s�o aplicadas</a></h2>
<p>As diretrizes de configura��o que se encontram em um arquivo
<code>.htaccess</code> s�o aplicadas para o diret�rio no qual o
arquivo <code>.htaccess</code> se encontra, e para todos os
subdiret�rios ali presentes. Mas, � importante lembrar tamb�m que
podem existir arquivos <code>.htaccess</code> no diret�rios
superiores. As diretrizes s�o aplicadas na ordem que s�o
achadas. Logo, um arquivo <code>.htaccess</code> em um diret�rio
em particular, pode sobrescrever as diretrizes encontradas em um
diret�rio acima deste em sua respectiva �rvore. Estes, por sua vez,
podem ter suas diretrizes sobrescritas por diretrizes ainda mais
acima, ou no pr�prio arquivo de configura��o principal do
servidor.</p>
<p>Exemplo:</p>
<p>No diret�rio <code>/www/htdocs/example1</code> n�s temos
um arquivo <code>.htaccess</code> contendo o seguinte:</p>
<div class="example"><p><code>
Options +ExecCGI
</code></p></div>
<p>(Nota: voc� deve ter "<code>AllowOverride Options</code>" para
permitir o uso da diretriz "<code class="directive"><a href="../mod/core.html#options">Options</a></code>" nos arquivos
<code>.htaccess</code> .)</p>
<p>No diret�rio <code>/www/htdocs/example1/example2</code> n�s temos
um arquivo <code>.htaccess</code> contendo:</p>
<div class="example"><p><code>
Options Includes
</code></p></div>
<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"><Directory></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"> en </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 2008 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>
</body></html>
|
