Apache HTTP 伺服器 2.4 版
根據類別整理,這是針對不同 AllowOverride
設定值,在 .htaccess 檔案中允許的指令索引。用於幫助伺服器管理員驗證他們授與 .htaccess 使用者的權限。若要了解 .htaccess 的運作原理,請參考 .htaccess 教學指南。
若要確認你的伺服器組態允許 .htaccess 使用者使用的指令集
AllowOverrideList
中的指令集開始。(預設設定為 None
。)AllowOverride
設定值。(預設設定為 None
。)有兩個特殊狀況AllowOverride
設定為 All
,請將此頁面中列出的每個指令新增至清單。AllowOverride
設定為 None
,請停止操作。只有 AllowOverrideList
中的指令(如果有)將被允許。AllowOverride
中列出的每個覆寫類別,尋找下列對應的指令集並將它們新增至清單。其中有幾個覆寫類別非常強大,讓 .htaccess 使用者可以大範圍控制伺服器。對於更嚴謹的方法,請設定 AllowOverride None
並使用 AllowOverrideList
指定 .htaccess 使用者可以使用的精確指令清單。
如果在伺服器組態中啟用了覆寫,則可以在任何 .htaccess 檔案中允許下列指令。
<Else> | 核心 |
包含僅在 <If> 或 <ElseIf> 部分的前一個條件不符合執行時間的要求時才會套用的指令 | |
<ElseIf> | 核心 |
包含當要求在執行階段滿足特定條件且先前 <If> 或 <ElseIf> 區段的條件未滿足時才套用的指令 | |
<Files> | 核心 |
包含適用於符合檔名的指令 | |
<FilesMatch> | 核心 |
包含適用於符合正規表示式檔名的指令 | |
<If> | 核心 |
當要求在執行階段符合特定條件時才套用的指令 | |
<IfDefine> | 核心 |
包含在啟動時測試為 true 才會處理的指令 | |
<IfDirective> | 核心 |
包含在有或沒有特定指令時處理的指令 | |
<IfFile> | 核心 |
當在啟動時存在檔案時才包含處理的指令 | |
<IfModule> | 核心 |
包含在有或沒有特定模組時處理的指令 | |
<IfSection> | 核心 |
包含在有或沒有特定區段指令時處理的指令 | |
<IfVersion> | mod_version |
包含與版本相關的組態 | |
LimitRequestBody | 核心 |
限制從客戶端送出的 HTTP 要求主體總大小 | |
LimitXMLRequestBody | 核心 |
限制基於 XML 的要求主體大小 | |
LogIOTrackTTFB | mod_logio |
啟用追蹤至第一個位元組(TTFB)的時間 | |
LuaCodeCache | mod_lua |
組態已編譯的程式碼快取。 | |
LuaHookAccessChecker | mod_lua |
提供在要求處理存取檢查器階段的鉤子 | |
LuaHookAuthChecker | mod_lua |
提供在要求處理驗證檢查器階段的鉤子 | |
LuaHookCheckUserID | mod_lua |
提供在要求處理檢查使用者 ID 階段的鉤子 | |
LuaHookFixups | mod_lua |
提供在要求處理修正階段的鉤子 | |
LuaHookInsertFilter | mod_lua |
提供在要求處理插入篩選器階段的鉤子 | |
LuaHookLog | mod_lua |
提供在要求處理存取日誌階段的鉤子 | |
LuaHookMapToStorage | mod_lua |
提供在要求處理對應至儲存階段的鉤子 | |
LuaHookPreTranslate | mod_lua |
提供在要求處理前翻譯階段的鉤子 | |
LuaHookTranslateName | mod_lua |
提供在要求處理翻譯名稱階段的鉤子 | |
LuaHookTypeChecker | mod_lua |
提供在要求處理類型檢查器階段的鉤子 | |
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 |
為一次、要求、連接、執行緒之一 -- 預設為一次 | |
RLimitCPU | 核心 |
限制由 Apache httpd 子行程啟動的程序之 CPU 使用量 | |
RLimitMEM | 核心 |
限制由 Apache httpd 子行程啟動的程序之記憶體使用量 | |
RLimitNPROC | 核心 |
限制由 Apache httpd 子行程啟動的程序可以啟動的程序數量 | |
ServerSignature | 核心 |
設定伺服器產生文件中的頁尾 | |
SSIErrorMsg | mod_include |
當發生 SSI 錯誤時顯示的錯誤訊息 | |
SSITimeFormat | mod_include |
設定顯示日期字串的格式 | |
SSIUndefinedEcho | mod_include |
當呼叫未設定變數時顯示的字串 |
在 AllowOverride AuthConfig
生效時,可以在 .htaccess 檔案中使用下列指令。它們讓 .htaccess 使用者能夠控管套用至其目錄子樹上的驗證和授權方式,包括幾個用於處理工作階段和 TLS 設定的相關公用程式指令。
當 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 |
設定有條件的環境變數取決於使用者代理,不區分大小寫 | |
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 |
將「HTTPOnly」屬性新增到 cookie | |
CookieName | mod_usertrack |
追蹤 cookie 的名稱 | |
CookieSameSite | mod_usertrack |
將「SameSite」屬性新增到 cookie | |
CookieSecure | mod_usertrack |
將「Secure」屬性新增到 cookie | |
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 |
在使用多重檢視搜尋符合檔案時所包含的檔案類型 | |
PassEnv | mod_env |
從殼層傳遞環境變數 | |
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 |
從環境中移除變數 |
當 AllowOverride Indexes
生效時,允許在 .htaccess 檔案中使用下列指令。它們允許 .htaccess 使用者控制伺服器提供的目錄索引頁面,包括自動索引產生。
當 AllowOverride Limit
生效時,下列指令可用於 .htaccess 檔案中。這種類型允許存取的範圍極為狹隘,主要用途是使用 mod_access_compat
所提供的舊型認證指令。
Allow | mod_access_compat |
控制哪些主機可以存取伺服器的區域 | |
Deny | mod_access_compat |
控制哪些主機會被拒絕存取伺服器 | |
<Limit> | 核心 |
限制封裝的存取控制僅適用於某些 HTTP 方法 | |
<LimitExcept> | 核心 |
限制存取控制僅適用於所有 HTTP 方法,但排除指定的 HTTP 方法 | |
順序 | mod_access_compat |
控制預設存取狀態和評估 Allow 和 Deny 的順序。 |
當 AllowOverride Options
生效時,在 .htaccess 檔案中允許以下指令。它們讓 .htaccess 使用者存取 Options
和類似的指令,以及控制濾器鏈的指令。
CheckBasenameMatch | mod_speling |
也比對副檔名不同的檔案。 | |
CheckCaseOnly | mod_speling |
將 speling 模組的動作限制在大寫小寫更正。 | |
CheckSpelling | mod_speling |
啟用拼寫模組 | |
ContentDigest | 核心 |
啟用 Content-MD5 HTTP 回應標頭的產生 | |
FilterChain | mod_filter |
設定濾器鏈 | |
FilterDeclare | mod_filter |
宣告一個智慧濾器 | |
FilterProtocol | mod_filter |
處理正確的 HTTP 協定處理 | |
FilterProvider | mod_filter |
註冊內容濾器 | |
選項 | 核心 |
設定特定目錄中有哪些功能可用 | |
ReflectorHeader | mod_reflector |
將輸入標頭反映至輸出標頭 | |
SSLOptions | mod_ssl |
設定各種 SSL 引擎執行時期選項 | |
XBitHack | mod_include |
解析設定了執行位的文件中的 SSI 指令 |