📄 htaccess.html
字号:
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312" />
<meta name="keywords" content="Apache, 中文, 手册, 中文版, 中文手册, 中文版手册, 参考手册, 中文参考手册, 金步国" />
<meta name="description" content="Apache 2.2 中文版参考手册" />
<meta name="author" content="金步国" />
<link href="../style/css/manual-zip.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="../style/css/manual-zip-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" />
<title>.htaccess文件 － Apache 2.2 中文版参考手册</title>
</head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/index.html">模块索引</a> | <a href="../mod/directives.html">指令索引</a> | <a href="../faq/index.html">常见问题</a> | <a href="../glossary.html">词汇表</a> | <a href="../sitemap.html">站点导航</a></p><p class="apache">Apache HTTP Server 版本2.2</p><img alt="" src="../images/feather.gif" /></div>
<div class="up"><a href="./index.html"><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/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">文档</a> > <a href="../index.html">版本2.2</a> > <a href="./index.html">如何.../指南</a></div>
<div id="translation-info"> <a href="../translator_announcement.html#thanks">致谢</a> | <a href="../translator_announcement.html#announcement">译者声明</a> | 本篇译者：<a href="mailto:csfrank@citiz.net">金步国</a> | 本篇译稿最后更新：2006年1月8日 | <a href="../translator_announcement.html#last_new">获取最新版本</a></div>
<div id="page-content"><div id="preamble"><h1>.htaccess文件</h1>
<p><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><a name="related" id="related">.htaccess 文件</a></h2>
<table border="1" cellpadding="0" cellspacing="0" bordercolor="#AAAAAA" class="related">
<tr><th>相关模块</th><th>相关指令</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">工作原理和使用方法</a></h2>
<p><code>.htaccess</code>文件(或者"分布式配置文件")提供了针对每个目录改变配置的方法，即在一个特定的目录中放置一个包含指令的文件，其中的指令作用于此目录及其所有子目录。</p>
<div class="note"><h3>说明：</h3>
<p>如果需要使用<code>.htaccess</code>以外的其他文件名，可以用<code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code>指令来改变。例如，需要使用<code>.config</code> ，则可以在服务器配置文件中按以下方法配置：</p>
<div class="example"><p><code>
AccessFileName .config
</code></p></div>
</div>
<p>通常，<code>.htaccess</code>文件使用的配置语法和<a href="../configuring.html#syntax">主配置文件</a>一样。<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>指令按类别决定了<code>.htaccess</code>文件中哪些指令才是有效的。如果一个指令允许在<code>.htaccess</code>中使用，那么在本手册的说明中，此指令会有一个<a href="../mod/directive-dict.html#Context">覆盖项</a>段，其中说明了为使此指令生效而必须在<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>指令中设置的值。</p>
<p>例如，本手册对<code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code>指令的阐述表明此指令可以用于<code>.htaccess</code>文件中(见"作用域"项)，而<a href="../mod/directive-dict.html#Context">覆盖项</a>一行是<code>FileInfo</code> ，那么为了使<code>.htaccess</code>中的此指令有效，则至少要设置 <code>AllowOverride FileInfo</code> 。</p>
<div class="example"><h3>例子：</h3><table border="1" cellpadding="0" cellspacing="0" bordercolor="#AAAAAA">
<tr><td><a href="../mod/directive-dict.html#Context">作用域</a></td><td>server config, virtual host, directory, .htaccess</td></tr>
<tr><td><a href="../mod/directive-dict.html#Override">覆盖项</a></td><td>FileInfo</td></tr>
</table></div>
<p>如果不能确定某个指令是否可以用于<code>.htaccess</code>文件，可以查阅手册中对指令的说明，看在"作用域"行中是否有".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">(不)使用.htaccess文件的场合</a></h2>
<p>一般情况下，不应该使用<code>.htaccess</code>文件，除非你对主配置文件没有访问权限。有一种很常见的误解，认为用户认证只能通过<code>.htaccess</code>文件实现，其实并不是这样，把用户认证写在主配置文件中是完全可行的，而且是一种很好的方法。</p>
<p><code>.htaccess</code>文件应该被用在内容提供者需要针对特定目录改变服务器的配置而又没有root权限的情况下。如果服务器管理员不愿意频繁修改配置，则可以允许用户通过<code>.htaccess</code>文件自己修改配置，尤其是ISP在同一个机器上运行了多个用户站点，而又希望用户可以自己改变配置的情况下。</p>
<p>虽然如此，一般都应该尽可能地避免使用<code>.htaccess</code>文件。任何希望放在<code>.htaccess</code>文件中的配置，都可以放在主配置文件的<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>段中，而且更高效。</p>
<p>避免使用<code>.htaccess</code>文件有两个主要原因。</p>
<p>首先是性能。如果<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>启用了<code>.htaccess</code>文件，则Apache需要在每个目录中查找<code>.htaccess</code>文件，因此，无论是否真正用到，启用<code>.htaccess</code>都会导致性能的下降。另外，对每一个请求，都需要读取一次<code>.htaccess</code>文件。</p>
<p>还有，Apache必须在所有上级的目录中查找<code>.htaccess</code>文件，以使所有有效的指令都起作用(参见<a href="#how">指令的生效</a>)，所以，如果请求<code>/www/htdocs/example</code>中的页面，Apache必须查找以下文件：</p>
<div class="example"><p><code>
/.htaccess<br />
/www/.htaccess<br />
/www/htdocs/.htaccess<br />
/www/htdocs/example/.htaccess
</code></p></div>
<p>总共要访问4个额外的文件，即使这些文件都不存在。(注意，这可能仅仅由于允许根目录"<code>/</code>"使用<code>.htaccess</code> ，虽然这种情况并不多。)</p>
<p>其次是安全。这样会允许用户自己修改服务器的配置，这可能会导致某些意想不到的修改，所以请认真考虑是否应当给予用户这样的特权。但是，如果给予用户较少的特权而不能满足其需要，则会带来额外的技术支持请求，所以，必须明确地告诉用户已经给予他们的权限，说明<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>设置的值，并引导他们参阅相应的说明，以免日后生出许多麻烦。</p>
<p>注意，在<code>/www/htdocs/example</code>目录下的<code>.htaccess</code>文件中放置指令，与在主配置文件中<code><Directory /www/htdocs/example></code>段中放置相同指令，是完全等效的。</p>
<p><code>/www/htdocs/example</code>目录下的<code>.htaccess</code>文件：</p>
<div class="example"><h3><code>/www/htdocs/example</code>目录下的.htaccess文件的内容：</h3><p><code>
AddType text/example .exm
</code></p></div>
<div class="example"><h3><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>但是，把配置放在主配置文件中更加高效，因为只需要在Apache启动时读取一次，而不是在每次文件被请求时都读取。</p>
<p>将<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>设置为<code>none</code>可以完全禁止使用<code>.htaccess</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">指令的生效</a></h2>
<p><code>.htaccess</code>文件中的配置指令作用于<code>.htaccess</code>文件所在的目录及其所有子目录，但是很重要的、需要注意的是，其上级目录也可能会有<code>.htaccess</code>文件，而指令是按查找顺序依次生效的，所以一个特定目录下的<code>.htaccess</code>文件中的指令可能会覆盖其上级目录中的<code>.htaccess</code>文件中的指令，即子目录中的指令会覆盖父目录或者主配置文件中的指令。</p>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -