.htaccess 文件中覆盖类索引

可用语言： en | fr

这是 .htaccess 文件中允许使用的指令的索引，这些指令针对各种 AllowOverride 设置，按类别组织。其目的是帮助服务器管理员验证他们授予 .htaccess 用户的权限。有关 .htaccess 工作原理的概述，请参阅 .htaccess 教程。

要确定您的服务器配置允许 .htaccess 用户使用的指令集

从所讨论目录的 AllowOverrideList 中的指令集开始。（默认情况下，它设置为 None。）
找到所讨论目录的 AllowOverride 设置。（默认情况下，它设置为 None。）有两种特殊情况
1. 如果您的 AllowOverride 设置为 All，请将此页面上列出的所有指令添加到列表中。
2. 如果您的 AllowOverride 设置为 None，则您已完成。仅允许 AllowOverrideList 中的指令（如果有）。
对于 AllowOverride 中列出的每个覆盖类，请查找下面的相应指令集并将它们添加到列表中。
最后，添加始终允许在 .htaccess 中使用的指令集（这些指令列在下面的所有部分中）。

几个覆盖类非常强大，并赋予 .htaccess 用户对服务器的大量控制权。对于更严格的方法，请设置 AllowOverride None 并使用 AllowOverrideList 来指定 .htaccess 用户允许使用的指令的确切列表。

另请参阅

所有

只要在服务器配置中启用了覆盖，以下指令就允许在任何 .htaccess 文件中使用。

<Else>	核心
包含仅在先前 `<If>` 或 `<ElseIf>` 部分的条件在运行时未满足请求时才适用的指令
<ElseIf>	核心
包含仅在运行时满足条件，而先前 `<If>` 或 `<ElseIf>` 部分的条件未满足时才适用的指令
<Files>	核心
包含适用于匹配的文件名的指令
<FilesMatch>	核心
包含适用于正则表达式匹配的文件名的指令
<If>	核心
包含仅在运行时满足条件时才适用的指令
<IfDefine>	核心
包含仅在启动时测试为真时才会处理的指令
<IfDirective>	核心
包含根据特定指令的存在或不存在进行处理的指令
<IfFile>	核心
包含仅在启动时文件存在时才会处理的指令
<IfModule>	核心
包含根据特定模块的存在或不存在进行处理的指令
<IfSection>	核心
包含根据特定部分指令的存在或不存在进行处理的指令
<IfVersion>	mod_version
包含版本相关的配置
LimitRequestBody	核心
限制从客户端发送的 HTTP 请求主体总大小
LimitXMLRequestBody	核心
限制基于 XML 的请求主体的大小
LogIOTrackTTFB	mod_logio
启用对首字节时间 (TTFB) 的跟踪
LuaCodeCache	mod_lua
配置已编译的代码缓存。
LuaHookAccessChecker	mod_lua
为请求处理的 access_checker 阶段提供一个钩子
LuaHookAuthChecker	mod_lua
为请求处理的 auth_checker 阶段提供一个钩子
LuaHookCheckUserID	mod_lua
为请求处理的 check_user_id 阶段提供一个钩子
LuaHookFixups	mod_lua
为请求处理的 fixups 阶段提供一个钩子
LuaHookInsertFilter	mod_lua
为请求处理的 insert_filter 阶段提供一个钩子
LuaHookLog	mod_lua
为请求处理的访问日志阶段提供一个钩子
LuaHookMapToStorage	mod_lua
为请求处理的 map_to_storage 阶段提供一个钩子
LuaHookPreTranslate	mod_lua
为请求处理的 pre_translate 阶段提供一个钩子
LuaHookTranslateName	mod_lua
为请求处理的 translate name 阶段提供一个钩子
LuaHookTypeChecker	mod_lua
为请求处理的 type_checker 阶段提供一个钩子
LuaInherit	mod_lua
控制父配置部分如何合并到子部分
LuaMapHandler	mod_lua
将路径映射到 lua 处理程序
LuaPackageCPath	mod_lua
将目录添加到 lua 的 package.cpath
LuaPackagePath	mod_lua
将目录添加到 lua 的 package.path
LuaQuickHandler	mod_lua
为请求处理的快速处理程序提供一个钩子
LuaRoot	mod_lua
指定用于解析 mod_lua 指令的相对路径的基路径
LuaScope	mod_lua
once、request、conn、thread 之一 - 默认值为 once
RLimitCPU	核心
限制 Apache httpd 子进程启动的进程的 CPU 消耗
RLimitMEM	核心
限制 Apache httpd 子进程启动的进程的内存消耗
RLimitNPROC	核心
限制 Apache httpd 子进程启动的进程可以启动的进程数
ServerSignature	核心
配置服务器生成的文档的页脚
SSIErrorMsg	mod_include
当出现 SSI 错误时显示的错误消息
SSITimeFormat	mod_include
配置日期字符串显示的格式
SSIUndefinedEcho	mod_include
当回显未设置的变量时显示的字符串

AuthConfig

当 AllowOverride AuthConfig 生效时，以下指令允许在 .htaccess 文件中使用。它们使 .htaccess 用户可以控制应用于其目录子树的认证和授权方法，包括用于会话处理和 TLS 设置的几个相关实用程序指令。

Anonymous	mod_authn_anon
指定允许在没有密码验证的情况下访问的用户 ID
Anonymous_LogEmail	mod_authn_anon
设置是否在错误日志中记录输入的密码
Anonymous_MustGiveEmail	mod_authn_anon
指定是否允许空白密码
Anonymous_NoUserID	mod_authn_anon
设置用户 ID 字段是否可以为空
Anonymous_VerifyEmail	mod_authn_anon
设置是否检查密码字段是否为格式正确的电子邮件地址
AuthBasicAuthoritative	mod_auth_basic
设置是否将授权和认证传递给更低级别的模块
AuthBasicFake	mod_auth_basic
使用给定的用户名和密码表达式伪造基本认证
AuthBasicProvider	mod_auth_basic
设置此位置的认证提供程序
AuthBasicUseDigestAlgorithm	mod_auth_basic
将密码与认证提供程序进行比较，就像 Digest 认证生效而不是 Basic 认证一样。
AuthDBMGroupFile	mod_authz_dbm
设置包含授权用户组列表的数据库文件的名称
AuthDBMType	mod_authn_dbm
设置用于存储密码的数据库文件的类型
AuthDBMUserFile	mod_authn_dbm
设置包含认证用户和密码列表的数据库文件的名称
AuthDigestAlgorithm	mod_auth_digest
选择用于计算摘要认证中质询和响应哈希的算法
AuthDigestDomain	mod_auth_digest
位于摘要认证相同保护空间中的 URI
AuthDigestNonceLifetime	mod_auth_digest
服务器 nonce 有效的时间长度
AuthDigestProvider	mod_auth_digest
设置此位置的认证提供程序
AuthDigestQop	mod_auth_digest
确定在摘要认证中使用的保护质量
AuthFormAuthoritative	mod_auth_form
设置是否将授权和认证传递给更低级别的模块
AuthFormProvider	mod_auth_form
设置此位置的认证提供程序
AuthGroupFile	mod_authz_groupfile
设置包含授权用户组列表的文本文件的名称
AuthLDAPAuthorizePrefix	mod_authnz_ldap
指定在授权期间设置的环境变量的前缀
AuthLDAPBindAuthoritative	mod_authnz_ldap
确定当用户可以映射到 DN 但服务器无法使用用户的凭据成功绑定时是否使用其他认证提供程序。
AuthLDAPBindDN	mod_authnz_ldap
绑定到 LDAP 服务器时使用的可选 DN
AuthLDAPBindPassword	mod_authnz_ldap
与绑定 DN 一起使用的密码
AuthLDAPCompareAsUser	mod_authnz_ldap
使用已认证用户的凭据执行授权比较
AuthLDAPCompareDNOnServer	mod_authnz_ldap
使用 LDAP 服务器比较 DN
AuthLDAPDereferenceAliases	mod_authnz_ldap
模块何时取消引用别名
AuthLDAPGroupAttribute	mod_authnz_ldap
用于标识用户组成员的 LDAP 属性。
AuthLDAPGroupAttributeIsDN	mod_authnz_ldap
在检查组成员资格时使用客户端用户名的 DN
AuthLDAPInitialBindAsUser	mod_authnz_ldap
确定服务器是否使用基本认证用户的用户名执行初始 DN 查找，而不是匿名或使用服务器的硬编码凭据
AuthLDAPInitialBindPattern	mod_authnz_ldap
指定绑定到 LDAP 服务器以执行 DN 查找时基本认证用户名的转换
AuthLDAPMaxSubGroupDepth	mod_authnz_ldap
指定在停止用户搜索之前将评估的最大子组嵌套深度。
AuthLDAPRemoteUserAttribute	mod_authnz_ldap
使用用户查询期间返回的属性的值设置 REMOTE_USER 环境变量
AuthLDAPRemoteUserIsDN	mod_authnz_ldap
使用客户端用户名的 DN 设置 REMOTE_USER 环境变量
AuthLDAPSearchAsUser	mod_authnz_ldap
使用已认证用户的凭据执行授权搜索
AuthLDAPSubGroupAttribute	mod_authnz_ldap
指定属性标签（每个指令行一个值），用于区分当前组中是组的成员。
AuthLDAPSubGroupClass	mod_authnz_ldap
指定哪些 LDAP objectClass 值在子组处理期间标识是组的目录对象。
AuthLDAPURL	mod_authnz_ldap
指定 LDAP 搜索参数的 URL
AuthMerging	mod_authz_core
控制每个配置部分的授权逻辑如何与前面配置部分的授权逻辑组合。
AuthName	mod_authn_core
用于 HTTP 认证的授权领域
AuthnCacheProvideFor	mod_authn_socache
指定要缓存的 authn 提供程序
AuthnCacheTimeout	mod_authn_socache
设置缓存条目的超时时间
AuthType	mod_authn_core
用户认证类型
AuthUserFile	mod_authn_file
设置包含认证用户和密码列表的文本文件的名称
AuthzDBMType	mod_authz_dbm
设置用于存储用户组列表的数据库文件的类型
CGIPassAuth	核心
启用将 HTTP 授权标头作为 CGI 变量传递给脚本
LDAPReferralHopLimit	mod_ldap
在终止 LDAP 查询之前，要追溯的最大推荐跳转次数。
LDAPReferrals	mod_ldap
在查询 LDAP 服务器期间启用推荐追溯。
<Limit>	核心
将封闭的访问控制限制为仅某些 HTTP 方法。
<LimitExcept>	核心
将访问控制限制为除命名方法之外的所有 HTTP 方法。
Require	mod_authz_core
测试经过身份验证的用户是否已获得授权提供者的授权。
<RequireAll>	mod_authz_core
包含一组授权指令，其中所有指令都不能失败，并且至少一个指令必须成功，才能使封闭指令成功。
<RequireAny>	mod_authz_core
包含一组授权指令，其中一个指令必须成功，才能使封闭指令成功。
<RequireNone>	mod_authz_core
包含一组授权指令，其中所有指令都不能成功，才能使封闭指令不失败。
Satisfy	mod_access_compat
主机级访问控制与用户身份验证之间的交互。
Session	mod_session
为当前目录或位置启用会话。
SessionEnv	mod_session
控制是否将会话内容写入 `HTTP_SESSION` 环境变量。
SessionHeader	mod_session
从给定的 HTTP 响应头导入会话更新。
SessionInclude	mod_session
定义会话有效的 URL 前缀。
SessionMaxAge	mod_session
定义会话的最大生存时间（以秒为单位）。
SSLCipherSuite	mod_ssl
SSL 握手协商中可用的密码套件。
SSLRenegBufferSize	mod_ssl
设置 SSL 重新协商缓冲区的大小。
SSLRequire	mod_ssl
仅在任意复杂的布尔表达式为真时才允许访问。
SSLRequireSSL	mod_ssl
在未为 HTTP 请求使用 SSL 时拒绝访问。
SSLUserName	mod_ssl
确定用户名的变量名。
SSLVerifyClient	mod_ssl
客户端证书验证的类型。
SSLVerifyDepth	mod_ssl
客户端证书验证中 CA 证书的最大深度。

FileInfo

当 AllowOverride FileInfo 生效时，以下指令允许在 .htaccess 文件中使用。它们为 .htaccess 用户提供了对服务器提供的响应和元数据的广泛控制。

AcceptPathInfo	核心
资源接受尾随路径信息。
Action	mod_actions
为特定处理程序或内容类型激活 CGI 脚本。
AddCharset	mod_mime
将给定的文件名扩展名映射到指定的内容字符集。
AddDefaultCharset	核心
当响应内容类型为 `text/plain` 或 `text/html` 时，要添加的默认字符集参数。
AddEncoding	mod_mime
将给定的文件名扩展名映射到指定的编码类型。
AddHandler	mod_mime
将文件名扩展名映射到指定的处理程序。
AddInputFilter	mod_mime
将文件名扩展名映射到将处理客户端请求的过滤器。
AddLanguage	mod_mime
将给定的文件名扩展名映射到指定的内容语言。
AddOutputFilter	mod_mime
将文件名扩展名映射到将处理来自服务器的响应的过滤器。
AddOutputFilterByType	mod_filter
将输出过滤器分配给特定媒体类型。
AddType	mod_mime
将给定的文件名扩展名映射到指定的内容类型。
BrowserMatch	mod_setenvif
根据 HTTP User-Agent 设置环境变量。
BrowserMatchNoCase	mod_setenvif
根据 User-Agent 设置环境变量，不区分大小写。
CGIMapExtension	核心
用于查找 CGI 脚本解释器的技术。
CGIVar	核心
控制某些 CGI 变量的设置方式。
CharsetDefault	mod_charset_lite
要翻译到的字符集。
CharsetOptions	mod_charset_lite
配置字符集翻译行为。
CharsetSourceEnc	mod_charset_lite
文件的源字符集。
CookieDomain	mod_usertrack
跟踪 cookie 适用的域。
CookieExpires	mod_usertrack
跟踪 cookie 的过期时间。
CookieHTTPOnly	mod_usertrack
向 cookie 添加 'HTTPOnly' 属性。
CookieName	mod_usertrack
跟踪 cookie 的名称。
CookieSameSite	mod_usertrack
向 cookie 添加 'SameSite' 属性。
CookieSecure	mod_usertrack
向 cookie 添加 'Secure' 属性。
CookieStyle	mod_usertrack
cookie 头字段的格式。
CookieTracking	mod_usertrack
启用跟踪 cookie。
DefaultLanguage	mod_mime
定义一个默认语言标签，该标签将在 Content-Language 头字段中发送，用于当前上下文中所有未通过其他方式分配语言标签的资源。
DefaultType	核心
此指令除了在值为 `none` 时发出警告之外，没有其他作用。在之前的版本中，DefaultType 会指定一个默认媒体类型，分配给无法找到其他媒体类型配置的响应内容。
EnableMMAP	核心
使用内存映射在交付期间读取文件。
EnableSendfile	核心
使用内核 sendfile 支持将文件交付给客户端。
ErrorDocument	核心
服务器在发生错误时将返回给客户端的内容。
FileETag	核心
用于为静态文件创建 ETag HTTP 响应头的文件属性。
ForceLanguagePriority	mod_negotiation
如果未找到单个可接受的文档，则采取的操作。
ForceType	核心
强制所有匹配的文件在 HTTP Content-Type 头字段中使用指定的媒体类型提供服务。
Header	mod_headers
配置 HTTP 响应头。
ISAPIAppendLogToErrors	mod_isapi
将来自 ISAPI 扩展的 `HSE_APPEND_LOG_PARAMETER` 请求记录到错误日志。
ISAPIAppendLogToQuery	mod_isapi
将来自 ISAPI 扩展的 `HSE_APPEND_LOG_PARAMETER` 请求记录到查询字段。
ISAPIFakeAsync	mod_isapi
为 ISAPI 回调模拟异步支持。
ISAPILogNotSupported	mod_isapi
记录来自 ISAPI 扩展的未支持功能请求。
ISAPIReadAheadBuffer	mod_isapi
发送到 ISAPI 扩展的预读缓冲区的大小。
LanguagePriority	mod_negotiation
客户端未表达偏好时，语言变体的优先级。
MultiviewsMatch	mod_mime
使用 MultiViews 搜索匹配文件时，将包含的文件类型。
PassEnv	mod_env
传递来自 shell 的环境变量。
QualifyRedirectURL	核心
控制 REDIRECT_URL 环境变量是否完全限定。
Redirect	mod_alias
发送外部重定向，要求客户端获取不同的 URL。
RedirectMatch	mod_alias
根据当前 URL 的正则表达式匹配发送外部重定向。
RedirectPermanent	mod_alias
发送外部永久重定向，要求客户端获取不同的 URL。
RedirectTemp	mod_alias
发送外部临时重定向，要求客户端获取不同的 URL。
RemoveCharset	mod_mime
删除一组文件扩展名的所有字符集关联。
RemoveEncoding	mod_mime
删除一组文件扩展名的所有内容编码关联。
RemoveHandler	mod_mime
删除一组文件扩展名的所有处理程序关联。
RemoveInputFilter	mod_mime
删除一组文件扩展名的所有输入过滤器关联。
RemoveLanguage	mod_mime
删除一组文件扩展名的所有语言关联。
RemoveOutputFilter	mod_mime
删除一组文件扩展名的所有输出过滤器关联。
RemoveType	mod_mime
删除一组文件扩展名的所有内容类型关联。
RequestHeader	mod_headers
配置 HTTP 请求头。
RewriteBase	mod_rewrite
设置每个目录重写的基本 URL。
RewriteCond	mod_rewrite
定义重写将发生的条件。
RewriteEngine	mod_rewrite
启用或禁用运行时重写引擎。
RewriteOptions	mod_rewrite
为重写引擎设置一些特殊选项。
RewriteRule	mod_rewrite
为重写引擎定义规则。
ScriptInterpreterSource	核心
用于查找 CGI 脚本解释器的技术。
SetEnv	mod_env
设置环境变量。
SetEnvIf	mod_setenvif
根据请求的属性设置环境变量。
SetEnvIfExpr	mod_setenvif
根据 ap_expr 表达式设置环境变量。
SetEnvIfNoCase	mod_setenvif
根据请求的属性设置环境变量，不区分大小写。
SetHandler	核心
强制所有匹配的文件由处理程序处理。
SetInputFilter	核心
设置将处理客户端请求和 POST 输入的过滤器。
SetOutputFilter	核心
设置将处理来自服务器的响应的过滤器。
Substitute	mod_substitute
用于过滤响应内容的模式。
SubstituteInheritBefore	mod_substitute
更改继承模式的合并顺序。
SubstituteMaxLineLength	mod_substitute
设置最大行大小。
UnsetEnv	mod_env
从环境中删除变量。

Indexes

当 AllowOverride Indexes 生效时，以下指令允许在 .htaccess 文件中使用。它们允许 .htaccess 用户控制服务器提供的目录索引页面的各个方面，包括自动索引生成。

AddAlt	mod_autoindex
为文件显示的备用文本，而不是由文件名选择的图标。
AddAltByEncoding	mod_autoindex
为文件显示的备用文本，而不是由 MIME 编码选择的图标。
AddAltByType	mod_autoindex
为文件显示的备用文本，而不是由 MIME 内容类型选择的图标。
AddDescription	mod_autoindex
为文件显示的描述。
AddIcon	mod_autoindex
为由名称选择的显示文件图标。
AddIconByEncoding	mod_autoindex
显示在由 MIME 内容编码选择的旁边文件的图标。
AddIconByType	mod_autoindex
显示在由 MIME 内容类型选择的旁边文件的图标。
DefaultIcon	mod_autoindex
当未配置特定图标时，为文件显示的图标。
DirectoryCheckHandler	mod_dir
切换此模块在配置了其他处理程序时的响应方式。
DirectoryIndex	mod_dir
客户端请求目录时要查找的资源列表。
DirectoryIndexRedirect	mod_dir
配置目录索引的外部重定向。
DirectorySlash	mod_dir
切换尾随斜杠重定向的启用或禁用。
ExpiresActive	mod_expires
启用 `Expires` 头的生成。
ExpiresByType	mod_expires
由 MIME 类型配置的 `Expires` 头的值。
ExpiresDefault	mod_expires
计算过期时间的默认算法。
FallbackResource	mod_dir
为未映射到文件的请求定义一个默认 URL。
HeaderName	mod_autoindex
将插入到索引列表顶部的文件名称。
ImapBase	mod_imagemap
图像映射文件的默认 `base`。
ImapDefault	mod_imagemap
当图像映射使用未明确映射的坐标调用时，默认操作。
ImapMenu	mod_imagemap
调用图像映射时，如果未给出坐标，则采取的操作。
IndexHeadInsert	mod_autoindex
在索引页面的 HEAD 部分插入文本。
IndexIgnore	mod_autoindex
添加到列出目录时要隐藏的文件列表。
IndexIgnoreReset	mod_autoindex
清空列出目录时要隐藏的文件列表。
IndexOptions	mod_autoindex
目录索引的各种配置设置。
IndexOrderDefault	mod_autoindex
设置目录索引的默认排序。
IndexStyleSheet	mod_autoindex
向目录索引添加 CSS 样式表。
MetaDir	mod_cern_meta
查找 CERN 风格元信息文件的目录名称。
MetaFiles	mod_cern_meta
激活 CERN 元文件处理。
MetaSuffix	mod_cern_meta
包含 CERN 风格元信息的文件的文件名后缀
ReadmeName	mod_autoindex
将在索引列表末尾插入的文件的名称

Limit

当 AllowOverride Limit 生效时，以下指令在 .htaccess 文件中允许使用。这种极其狭窄的覆盖类型主要允许使用由 mod_access_compat 提供的传统授权指令。

Allow	mod_access_compat
控制哪些主机可以访问服务器的某个区域
Deny	mod_access_compat
控制哪些主机被拒绝访问服务器
<Limit>	核心
将封闭的访问控制限制为仅某些 HTTP 方法。
<LimitExcept>	核心
将访问控制限制为除命名方法之外的所有 HTTP 方法。
Order	mod_access_compat
控制默认访问状态以及 `Allow` 和 `Deny` 的评估顺序。

Options

当 AllowOverride Options 生效时，以下指令在 .htaccess 文件中允许使用。它们使 .htaccess 用户能够访问 Options 和类似指令，以及控制过滤器链的指令。

CheckBasenameMatch	mod_speling
也匹配具有不同文件名扩展名的文件。
CheckCaseOnly	mod_speling
将拼写模块的操作限制为大小写校正
CheckSpelling	mod_speling
启用拼写模块
ContentDigest	核心
启用生成 `Content-MD5` HTTP 响应头
FilterChain	mod_filter
配置过滤器链
FilterDeclare	mod_filter
声明一个智能过滤器
FilterProtocol	mod_filter
处理正确的 HTTP 协议处理
FilterProvider	mod_filter
注册一个内容过滤器
Options	核心
配置特定目录中可用的功能
ReflectorHeader	mod_reflector
将输入头反射到输出头
SSLOptions	mod_ssl
配置各种 SSL 引擎运行时选项
XBitHack	mod_include
解析已设置执行位的文件的 SSI 指令