<-
Apache > HTTP 伺服器 > 文件 > 2.4 版

指定 .htaccess 的覆寫類別

可用語言:  en  |  fr 

根據類別整理,這是針對不同 AllowOverride 設定值,在 .htaccess 檔案中允許的指令索引。用於幫助伺服器管理員驗證他們授與 .htaccess 使用者的權限。若要了解 .htaccess 的運作原理,請參考 .htaccess 教學指南

若要確認你的伺服器組態允許 .htaccess 使用者使用的指令集

  1. 從目錄的 AllowOverrideList 中的指令集開始。(預設設定為 None。)
  2. 找出目錄的 AllowOverride 設定值。(預設設定為 None。)有兩個特殊狀況
    1. 如果 AllowOverride 設定為 All,請將此頁面中列出的每個指令新增至清單。
    2. 如果 AllowOverride 設定為 None,請停止操作。只有 AllowOverrideList 中的指令(如果有)將被允許。
  3. 針對在 AllowOverride 中列出的每個覆寫類別,尋找下列對應的指令集並將它們新增至清單。
  4. 最後,請新增在 .htaccess 中總是允許的指令集(這些指令列於下列 所有 區段)。

其中有幾個覆寫類別非常強大,讓 .htaccess 使用者可以大範圍控制伺服器。對於更嚴謹的方法,請設定 AllowOverride None 並使用 AllowOverrideList 指定 .htaccess 使用者可以使用的精確指令清單。

主題

另請參閱

top

所有

如果在伺服器組態中啟用了覆寫,則可以在任何 .htaccess 檔案中允許下列指令。

<Else>核心
包含僅在 <If><ElseIf> 部分的前一個條件不符合執行時間的要求時才會套用的指令
<ElseIf>核心
包含當要求在執行階段滿足特定條件且先前 <If><ElseIf> 區段的條件未滿足時才套用的指令
<Files>核心
包含適用於符合檔名的指令
<FilesMatch>核心
包含適用於符合正規表示式檔名的指令
<If>核心
當要求在執行階段符合特定條件時才套用的指令
<IfDefine>核心
包含在啟動時測試為 true 才會處理的指令
<IfDirective>核心
包含在有或沒有特定指令時處理的指令
<IfFile>核心
當在啟動時存在檔案時才包含處理的指令
<IfModule>核心
包含在有或沒有特定模組時處理的指令
<IfSection>核心
包含在有或沒有特定區段指令時處理的指令
<IfVersion>mod_version
包含與版本相關的組態
LimitRequestBody核心
限制從客戶端送出的 HTTP 要求主體總大小
LimitXMLRequestBody核心
限制基於 XML 的要求主體大小
LogIOTrackTTFBmod_logio
啟用追蹤至第一個位元組(TTFB)的時間
LuaCodeCachemod_lua
組態已編譯的程式碼快取。
LuaHookAccessCheckermod_lua
提供在要求處理存取檢查器階段的鉤子
LuaHookAuthCheckermod_lua
提供在要求處理驗證檢查器階段的鉤子
LuaHookCheckUserIDmod_lua
提供在要求處理檢查使用者 ID 階段的鉤子
LuaHookFixupsmod_lua
提供在要求處理修正階段的鉤子
LuaHookInsertFiltermod_lua
提供在要求處理插入篩選器階段的鉤子
LuaHookLogmod_lua
提供在要求處理存取日誌階段的鉤子
LuaHookMapToStoragemod_lua
提供在要求處理對應至儲存階段的鉤子
LuaHookPreTranslatemod_lua
提供在要求處理前翻譯階段的鉤子
LuaHookTranslateNamemod_lua
提供在要求處理翻譯名稱階段的鉤子
LuaHookTypeCheckermod_lua
提供在要求處理類型檢查器階段的鉤子
LuaInheritmod_lua
控制如何將父層組態區段合併至子層組態區段
LuaMapHandlermod_lua
將路徑對應至 lua 處理常式
LuaPackageCPathmod_lua
將目錄新增至 lua 的 package.cpath
LuaPackagePathmod_lua
將目錄新增至 lua 的 package.path
LuaQuickHandlermod_lua
提供在要求處理的快速處理常式中使用的鉤子
LuaRootmod_lua
指定 mod_lua 指令相對路徑解析的基本路徑
LuaScopemod_lua
為一次、要求、連接、執行緒之一 -- 預設為一次
RLimitCPU核心
限制由 Apache httpd 子行程啟動的程序之 CPU 使用量
RLimitMEM核心
限制由 Apache httpd 子行程啟動的程序之記憶體使用量
RLimitNPROC核心
限制由 Apache httpd 子行程啟動的程序可以啟動的程序數量
ServerSignature核心
設定伺服器產生文件中的頁尾
SSIErrorMsgmod_include
當發生 SSI 錯誤時顯示的錯誤訊息
SSITimeFormatmod_include
設定顯示日期字串的格式
SSIUndefinedEchomod_include
當呼叫未設定變數時顯示的字串
top

AuthConfig

AllowOverride AuthConfig 生效時,可以在 .htaccess 檔案中使用下列指令。它們讓 .htaccess 使用者能夠控管套用至其目錄子樹上的驗證和授權方式,包括幾個用於處理工作階段和 TLS 設定的相關公用程式指令。

Anonymousmod_authn_anon
指定允許無密碼驗證存取的使用者 ID
Anonymous_LogEmailmod_authn_anon
設定是否將輸入的密碼記錄在錯誤記錄檔中
Anonymous_MustGiveEmailmod_authn_anon
指定是否允許空白密碼
Anonymous_NoUserIDmod_authn_anon
設定使用者 ID 欄位是否可以為空白
Anonymous_VerifyEmailmod_authn_anon
設定是否要檢查密碼欄位是否為正確格式的電子郵件地址
AuthBasicAuthoritativemod_auth_basic
設定是否將授權和驗證傳遞至較低層級的模組
AuthBasicFakemod_auth_basic
使用提供的使用者名稱和密碼表達式進行虛假基本驗證
AuthBasicProvidermod_auth_basic
設定此位置的驗證提供者
AuthBasicUseDigestAlgorithmmod_auth_basic
在驗證提供者中檢查密碼,就好像強制執行摘要驗證而非基本驗證一般。
AuthDBMGroupFilemod_authz_dbm
設定包含授權使用者群組清單的資料庫檔案名稱
AuthDBMTypemod_authn_dbm
設定用於儲存密碼的資料庫檔案類型
AuthDBMUserFilemod_authn_dbm
設定包含授權使用者和密碼清單的資料庫檔案名稱
AuthDigestAlgorithmmod_auth_digest
選取用於計算摘要驗證中挑戰與回應雜湊的演算法
AuthDigestDomainmod_auth_digest
在同一個摘要驗證保護區中的 URI
AuthDigestNonceLifetimemod_auth_digest
伺服器簡碼有效的時間長度
AuthDigestProvidermod_auth_digest
設定此位置的驗證提供者
AuthDigestQopmod_auth_digest
決定在摘要驗證中要使用的保護品質
AuthFormAuthoritativemod_auth_form
設定是否將授權和驗證傳遞至較低層級的模組
AuthFormProvidermod_auth_form
設定此位置的驗證提供者
AuthGroupFilemod_authz_groupfile
設定包含授權使用者群組清單的文字檔名稱
AuthLDAPAuthorizePrefixmod_authnz_ldap
指定在授權期間設定的環境變數的前置字元
AuthLDAPBindAuthoritativemod_authnz_ldap
如果使用者可以對應至 DN,但伺服器無法使用使用者的憑證成功繫結時,將決定是否使用其他驗證提供者。
AuthLDAPBindDNmod_authnz_ldap
用於繫結到 LDAP 伺服器的選用 DN
AuthLDAPBindPasswordmod_authnz_ldap
與繫結 DN 搭配使用的密碼
AuthLDAPCompareAsUsermod_authnz_ldap
使用已驗證使用者的憑證來執行授權比較
AuthLDAPCompareDNOnServermod_authnz_ldap
使用 LDAP 伺服器來比較 DN
AuthLDAPDereferenceAliasesmod_authnz_ldap
模組將解除參考別名
AuthLDAPGroupAttributemod_authnz_ldap
LDAP 屬性用於識別群組的使用者成員。
AuthLDAPGroupAttributeIsDNmod_authnz_ldap
在檢查群組成員資格時,使用用戶端使用者名稱的 DN
AuthLDAPInitialBindAsUsermod_authnz_ldap
決定伺服器是否使用基本驗證使用者的使用者名稱執行初始 DN 查詢,而不是以匿名方式執行或使用伺服器的硬編碼憑證
AuthLDAPInitialBindPatternmod_authnz_ldap
指定基本驗證使用者名稱的轉換,用於繫結到 LDAP 伺服器以執行 DN 查詢
AuthLDAPMaxSubGroupDepthmod_authnz_ldap
指定在使用者搜尋停止之前將評估的最大次群組巢狀深度。
AuthLDAPRemoteUserAttributemod_authnz_ldap
使用使用者查詢期間傳回的屬性值來設定 REMOTE_USER 環境變數
AuthLDAPRemoteUserIsDNmod_authnz_ldap
使用用戶端使用者名稱的 DN 來設定 REMOTE_USER 環境變數
AuthLDAPSearchAsUsermod_authnz_ldap
使用已驗證使用者的憑證來執行授權搜尋
AuthLDAPSubGroupAttributemod_authnz_ldap
指定屬性標籤,每個指令列一個值,用於區別當前群組中屬於群組的成員。
AuthLDAPSubGroupClassmod_authnz_ldap
指定哪些 LDAP objectClass 值識別次群組處理期間屬於群組的目錄物件。
AuthLDAPURLmod_authnz_ldap
指定 LDAP 搜尋參數的網址
AuthMergingmod_authz_core
控制每個組態區段的授權邏輯與之前組態區段的授權邏輯合併的方式。
AuthNamemod_authn_core
用於 HTTP 驗證的授權領域
AuthnCacheProvideFormod_authn_socache
指定要快取哪些驗證提供者
AuthnCacheTimeoutmod_authn_socache
設定快取條目的逾時時間
AuthTypemod_authn_core
使用者驗證類型
AuthUserFilemod_authn_file
設定包含使用者和驗證密碼文字檔案的名稱
AuthzDBMTypemod_authz_dbm
設定用於儲存使用者群組清單的資料庫檔案類型
CGIPassAuth核心
啟用將 HTTP 授權標頭傳遞給腳本作為 CGI 變數
LDAPReferralHopLimitmod_ldap
終止 LDAP 查詢之前を追蹤的最高轉介跳數。
LDAPReferralsmod_ldap
在查詢 LDAP 伺服器時啟用轉介追蹤。
<Limit>核心
限制封裝的存取控制僅適用於某些 HTTP 方法
<LimitExcept>核心
限制存取控制僅適用於所有 HTTP 方法,但排除指定的 HTTP 方法
Requiremod_authz_core
測試經過驗證的使用者是否已由授權供應者授權。
<RequireAll>mod_authz_core
封裝一組授權指令,其中所有指令都必須通過,而封裝指令至少必須通過一項才能成功。
<RequireAny>mod_authz_core
封裝一組授權指令,其中只要有一項指令通過,封裝指令即可成功。
<RequireNone>mod_authz_core
封裝一組授權指令,其中所有指令都必須不通過,封裝指令才能不失敗。
Satisfymod_access_compat
主機層級存取控制和使用者驗證之間的互動
Sessionmod_session
為目前的目錄或位置啟用一個會話
SessionEnvmod_session
控制會話的內容是否寫入 HTTP_SESSION 環境變數
SessionHeadermod_session
從給定的 HTTP 回應標頭匯入會話更新
SessionIncludemod_session
定義會話有效的 URL 前置詞
SessionMaxAgemod_session
定義一個會話的秒數最大年齡
SSLCipherSuitemod_ssl
在 SSL 交握中可協商的加密組
SSLRenegBufferSizemod_ssl
設定 SSL 重新協商緩衝區的大小
SSLRequiremod_ssl
僅在任意的複雜布林運算式為真時允許存取
SSLRequireSSLmod_ssl
當 HTTP 要求並未使用 SSL 時拒絕存取
SSLUserNamemod_ssl
確定使用者名稱的變數名稱
SSLVerifyClientmod_ssl
用戶端憑證驗證的類型
SSLVerifyDepthmod_ssl
用戶端憑證驗證中 CA 憑證的最大深度
top

FileInfo

AllowOverride FileInfo 生效時,.htaccess 檔案允許下列指令。它們讓 .htaccess 使用者可以廣泛地控制伺服器提供的回應和資料。

AcceptPathInfo核心
資源接受尾隨路徑名稱資訊
Actionmod_actions
為特定處理器或內容類型啟用 CGI 程式碼
AddCharsetmod_mime
將給定的檔案名稱副檔名對應到指定的內容字集
AddDefaultCharset核心
當回應內容類型為 text/plaintext/html 時要新增的預設字集參數
AddEncodingmod_mime
將給定的檔案名稱副檔名對應到指定的編碼類型
AddHandlermod_mime
將檔案名稱副檔名對應到指定的處理器
AddInputFiltermod_mime
將檔案名稱副檔名對應到將處理客戶端要求的濾鏡
AddLanguagemod_mime
將給定的檔案名稱副檔名對應到指定的內容語言
AddOutputFiltermod_mime
將檔案名稱副檔名對應到將處理伺服器回應的濾鏡
AddOutputFilterByTypemod_filter
將一個輸出濾鏡指派給一個特定的媒體類型
AddTypemod_mime
將指定的內容類型對應到指定的檔案副檔名
BrowserMatchmod_setenvif
設定有條件的環境變數取決於 HTTP User-Agent
BrowserMatchNoCasemod_setenvif
設定有條件的環境變數取決於使用者代理,不區分大小寫
CGIMapExtension核心
技術用於尋找 CGI 程式碼的直譯器
CGIVar核心
控制一些 CGI 變數的設定方式
CharsetDefaultmod_charset_lite
要翻譯的字元集
CharsetOptionsmod_charset_lite
設定字元集翻譯行為
CharsetSourceEncmod_charset_lite
檔案的原始字元集
CookieDomainmod_usertrack
追蹤 cookie 適用的網域
CookieExpiresmod_usertrack
追蹤 cookie 的到期時間
CookieHTTPOnlymod_usertrack
將「HTTPOnly」屬性新增到 cookie
CookieNamemod_usertrack
追蹤 cookie 的名稱
CookieSameSitemod_usertrack
將「SameSite」屬性新增到 cookie
CookieSecuremod_usertrack
將「Secure」屬性新增到 cookie
CookieStylemod_usertrack
cookie 標頭欄位的格式
CookieTrackingmod_usertrack
啟用追蹤 cookie
DefaultLanguagemod_mime
定義一個預設的語言標籤,將出現在所有目前脈絡中未透過其他方式指定語言標籤的資源的 Content-Language 標頭欄位中。
DefaultType核心
這個指令沒有任何效果,除非它的值不是「none」,才會發出警告訊息。在之前的版本中,DefaultType 會指定一個預設的媒體類型來配置其他找不到媒體類型設定的回應內容。
EnableMMAP核心
在傳送期間使用記憶體對映來讀取檔案
EnableSendfile核心
使用核心 sendfile 支援將檔案傳送給客戶端
ErrorDocument核心
當錯誤發生時,伺服器將傳送給客戶端的內容
FileETag核心
建立靜態檔案的 ETag HTTP 回應標頭時使用的檔案屬性
ForceLanguagePrioritymod_negotiation
如果找不到單一符合的檔案,要執行的動作
ForceType核心
強制所有符合的檔案使用指定媒體類型在 HTTP Content-Type 標頭欄位中傳遞
Headermod_headers
設定 HTTP 回應標頭
ISAPIAppendLogToErrorsmod_isapi
記錄 ISAPI 擴充功能所傳送至錯誤記錄的 HSE_APPEND_LOG_PARAMETER 請求
ISAPIAppendLogToQuerymod_isapi
記錄 ISAPI 擴充功能所傳送至查詢欄位的 HSE_APPEND_LOG_PARAMETER 請求
ISAPIFakeAsyncmod_isapi
偽裝 ISAPI 回呼的非同步支援
ISAPILogNotSupportedmod_isapi
記錄 ISAPI 擴充功能所傳送的不支援功能請求
ISAPIReadAheadBuffermod_isapi
傳送到 ISAPI 擴充功能的讀取超前緩衝區的大小
LanguagePrioritymod_negotiation
當客戶端未表達偏好時,語言變體的優先順序
MultiviewsMatchmod_mime
在使用多重檢視搜尋符合檔案時所包含的檔案類型
PassEnvmod_env
從殼層傳遞環境變數
QualifyRedirectURL核心
控制 REDIRECT_URL 環境變數是否完全限定
Redirectmod_alias
傳送外部重新導向,要求客戶端擷取相異的 URL
RedirectMatchmod_alias
依據目前的 URL 的正規表示式相符傳送外部重新導向
RedirectPermanentmod_alias
傳送外部永久重新導向,要求客戶端擷取相異的 URL
RedirectTempmod_alias
傳送外部暫時重新導向,要求客戶端擷取相異的 URL
RemoveCharsetmod_mime
移除一組檔案副檔名的任何字元集關聯
RemoveEncodingmod_mime
移除一組檔案副檔名的任何內容編碼關聯
RemoveHandlermod_mime
移除一組檔案副檔名的任何處理常式關聯
RemoveInputFiltermod_mime
移除一組檔案副檔名的任何輸入過濾器關聯
RemoveLanguagemod_mime
移除一組檔案副檔名的任何語言關聯
RemoveOutputFiltermod_mime
移除一組檔案副檔名的任何輸出過濾器關聯
RemoveTypemod_mime
移除一組檔案副檔名的任何內容類型關聯
RequestHeadermod_headers
設定 HTTP 要求標頭
RewriteBasemod_rewrite
設定每個目錄重寫的基本 URL
RewriteCondmod_rewrite
定義將進行重寫的條件
RewriteEnginemod_rewrite
啟用或停用執行時期重寫引擎
RewriteOptionsmod_rewrite
設定重寫引擎的一些特殊選項
RewriteRulemod_rewrite
定義重寫引擎的規則
ScriptInterpreterSource核心
技術用於尋找 CGI 程式碼的直譯器
SetEnvmod_env
設定環境變數
SetEnvIfmod_setenvif
根據要求的屬性設定環境變數
SetEnvIfExprmod_setenvif
根據 ap_expr 表達式設定環境變數
SetEnvIfNoCasemod_setenvif
根據要求的屬性(不論大小寫)設定環境變數
SetHandler核心
強制處理常式處理所有相符檔案
SetInputFilter核心
設定將處理客戶端要求和 POST 輸入的過濾器
SetOutputFilter核心
設定將處理伺服器回應的過濾器
Substitutemod_substitute
過濾回應內容的範本
SubstituteInheritBeforemod_substitute
變更繼承範本的合併順序
SubstituteMaxLineLengthmod_substitute
設定最大行長
UnsetEnvmod_env
從環境中移除變數
top

索引

AllowOverride Indexes 生效時,允許在 .htaccess 檔案中使用下列指令。它們允許 .htaccess 使用者控制伺服器提供的目錄索引頁面,包括自動索引產生。

AddAltmod_autoindex
圖片替代文字,取代依照檔名顯示的圖示
AddAltByEncodingmod_autoindex
依照 MIME 編碼所選的替代文字,取代檔案的圖示
AddAltByTypemod_autoindex
依照 MIME 內容類型所選的替代文字,取代檔案的圖示
AddDescriptionmod_autoindex
檔案的描述文字
AddIconmod_autoindex
以名稱選取的檔案圖示
AddIconByEncodingmod_autoindex
由 MIME 內容編碼選取檔案的圖示
AddIconByTypemod_autoindex
由 MIME 內容類型選取檔案的圖示
DefaultIconmod_autoindex
當沒有其他特定圖示時,可用於檔案顯示的圖示
DirectoryCheckHandlermod_dir
其他處理程序設定後,切換本模組的回應方式
DirectoryIndexmod_dir
當用戶端要求目錄時,要搜尋的資源清單
DirectoryIndexRedirectmod_dir
設定用於目錄索引的外部分派。
DirectorySlashmod_dir
切換開啟或關閉尾斜線分派
ExpiresActivemod_expires
啟用產生 Expires 標頭
ExpiresByTypemod_expires
由 MIME 類型設定的 Expires 標頭值
ExpiresDefaultmod_expires
用於計算過期時間的預設演算法
FallbackResourcemod_dir
定義未對應至檔案的要求預設 URL
HeaderNamemod_autoindex
將會插入索引列表最上方的檔案名稱
ImapBasemod_imagemap
預設 base 值,用於影像地圖檔
ImapDefaultmod_imagemap
當以並未明確對應座標呼叫影像地圖時,預設動作
ImapMenumod_imagemap
當呼叫影像地圖時,未提供座標的動作
IndexHeadInsertmod_autoindex
在索引頁面的 HEAD 區段中插入文字。
IndexIgnoremod_autoindex
新增至目錄清單檔案時,要隱藏的檔案列表
IndexIgnoreResetmod_autoindex
清空目錄清單檔案時,要隱藏的檔案列表
IndexOptionsmod_autoindex
目錄索引的各種設定
IndexOrderDefaultmod_autoindex
設定目錄索引的預設排序方式
IndexStyleSheetmod_autoindex
新增 CSS 樣式表至目錄索引
MetaDirmod_cern_meta
用於搜尋 CERN 式 meta 資訊檔案的目錄名稱
MetaFilesmod_cern_meta
啟用 CERN meta 檔案處理功能
MetaSuffixmod_cern_meta
包含 CERN 式 meta 資訊的檔案的副檔名
ReadmeNamemod_autoindex
將會插入索引列表最後方的檔案名稱
top

Limit

AllowOverride Limit 生效時,下列指令可用於 .htaccess 檔案中。這種類型允許存取的範圍極為狹隘,主要用途是使用 mod_access_compat 所提供的舊型認證指令。

Allowmod_access_compat
控制哪些主機可以存取伺服器的區域
Denymod_access_compat
控制哪些主機會被拒絕存取伺服器
<Limit>核心
限制封裝的存取控制僅適用於某些 HTTP 方法
<LimitExcept>核心
限制存取控制僅適用於所有 HTTP 方法,但排除指定的 HTTP 方法
順序mod_access_compat
控制預設存取狀態和評估 AllowDeny 的順序。
top

選項

AllowOverride Options 生效時,在 .htaccess 檔案中允許以下指令。它們讓 .htaccess 使用者存取 Options 和類似的指令,以及控制濾器鏈的指令。

CheckBasenameMatchmod_speling
也比對副檔名不同的檔案。
CheckCaseOnlymod_speling
將 speling 模組的動作限制在大寫小寫更正。
CheckSpellingmod_speling
啟用拼寫模組
ContentDigest核心
啟用 Content-MD5 HTTP 回應標頭的產生
FilterChainmod_filter
設定濾器鏈
FilterDeclaremod_filter
宣告一個智慧濾器
FilterProtocolmod_filter
處理正確的 HTTP 協定處理
FilterProvidermod_filter
註冊內容濾器
選項核心
設定特定目錄中有哪些功能可用
ReflectorHeadermod_reflector
將輸入標頭反映至輸出標頭
SSLOptionsmod_ssl
設定各種 SSL 引擎執行時期選項
XBitHackmod_include
解析設定了執行位的文件中的 SSI 指令

可用語言:  en  |  fr 

top

意見

註釋
這不是問答區段。放在此處的留言應指向關於改善文件或伺服器的建議,如果留言已實作或被視為無效/離題,我們的管理員可能會將其移除。關於如何管理 Apache HTTP 伺服器的問題應寄到我們的 IRC 頻道 (#httpd,在 Libera.chat 上),或寄到我們的 郵寄清單