Apache Module mod_mime

AddCharset 指令

AddCharset 指令將指定的文件名副檔名對應到指定的內容字元集（給定字元編碼的網際網路註冊名稱）。charset 是資源的媒體類型字元集參數，其檔案名稱含有 extension。此對應新增到任何已套用中的對應，覆寫已存在的任何對應，extension 相同。

AddLanguage ja .ja
AddCharset EUC-JP .euc
AddCharset ISO-2022-JP .jis
AddCharset SHIFT_JIS .sjis

然後文件 xxxx.ja.jis 將視為日文文件，其字元集為 ISO-2022-JP（文件 xxxx.jis.ja 也相同）。AddCharset 指令同時可用於通知用戶端文件的字元編碼，以便能適切地詮釋和顯示文件，也能用於 內容協商，其中伺服器根據用戶端字元集偏好設定，從多個文件中傳回一個。

extension 參數不區分大小寫，且可以加上或不加上開頭的句號來指定。檔案名稱可以有 多個副檔名，extension 參數會與每個副檔名進行比較。

相關資訊

• mod_negotiation
• AddDefaultCharset

AddEncoding 指令

AddEncoding 指令將指定的檔案名稱副檔名對應到指定的 HTTP 內容編碼。encoding 是要附加到 Content-Encoding 標頭欄位值的文件 HTTP 內容編碼，其名稱以 extension 指定。此對應新增到任何已套用中的對應，覆寫已存在的任何對應，extension 相同。

AddEncoding x-gzip .gz
AddEncoding x-compress .Z

這會將含有副檔名 .gz 的檔案標記為使用 x-gzip 編碼，將含有副檔名 .Z 的檔案標記為使用 x-compress 編碼。

舊版用戶端會期待 x-gzip 和 x-compress，但標準指示它們分別等於 gzip 和 compress。Apache 會忽略任何開頭的 x- 來比較內容編碼。當以編碼回應時，Apache 將使用用戶端要求的任何格式（例如 x-foo 或 foo）。如果用戶端沒有特別要求特定格式，Apache 將使用 AddEncoding 指令提供的格式。簡而言之，您應該總是針對這兩個特定編碼使用 x-gzip 和 x-compress。較新的編碼（例如 deflate）應該指定而沒有 x-。

extension 參數不區分大小寫，且可以加上或不加上開頭的句號來指定。檔案名稱可以有 多個副檔名，extension 參數會與每個副檔名進行比較。

AddHandler 指令

具有 extension 名稱的檔案將由指定的 handler-name 服務。此對應會新增至任何現已生效的對應，覆寫任何現已有相同 extension 的對應。例如，要以檔案副檔名 .cgi 啟用 CGI 腳本，您可能會使用

AddHandler cgi-script .cgi

只要已將其放入 httpd.conf 檔案中，任何包含 .cgi 副檔名的檔案都將被視為 CGI 程式。

extension 參數不區分大小寫，且可以加上或不加上開頭的句號來指定。檔案名稱可以有 多個副檔名，extension 參數會與每個副檔名進行比較。

相關資訊

• SetHandler

AddInputFilter 指令

AddInputFilter 將檔案名稱副檔名 extension 對應至將在伺服器收到時處理客戶端請求的 篩選器 和 POST 輸入。這會新增至任何其他地方定義的篩選器，包括 SetInputFilter 指令。此對應會合併到任何現已生效的對應，覆寫任何現已有相同 extension 的對應。

如果指定一個以上的 filter，它們必須按它們應該處理內容的順序以分號分隔。 filter 不分大小寫。

extension 參數不區分大小寫，且可以加上或不加上開頭的句號來指定。檔案名稱可以有 多個副檔名，extension 參數會與每個副檔名進行比較。

相關資訊

• RemoveInputFilter
• SetInputFilter

AddLanguage 指令

AddLanguage 指令將指定的檔案名稱副檔名對應至指定的內容語言。具有檔案名稱 extension 的檔案會指派一個 HTTP Content-Language 值為 language-tag，對應於 RFC 3066 所定義的語言識別碼。此指令會覆寫任何現已有相同 extension 的對應。

AddEncoding x-compress .Z
AddLanguage en .en
AddLanguage fr .fr

然後文件 xxxx.en.Z 將被視為一個壓縮的英文文件 (文件 xxxx.Z.en 也會是這樣)。即使內容語言已報告給客戶端，瀏覽器也不太可能會使用此資訊。AddLanguage 指令對於 內容協商 來說比較有用，在內容協商中，伺服器會根據客戶端的語言偏好從多個文件中回傳一個檔案。

如果為同一個副檔名做出多個語言指定，會使用遇到的最後一個。亦即，對於

AddLanguage en .en
AddLanguage en-gb .en
AddLanguage en-us .en

具有副檔名 .en 的文件將會被視為 en-us。

extension 參數不區分大小寫，且可以加上或不加上開頭的句號來指定。檔案名稱可以有 多個副檔名，extension 參數會與每個副檔名進行比較。

相關資訊

• mod_negotiation

AddOutputFilter 指令

指令 AddOutputFilter 會將副檔名 extension 映射至 filters，此 filter 會在回覆傳送給用戶端之前處理伺服器的回應。這會額外加入其他位置定義的 filter，包括 SetOutputFilter 和 AddOutputFilterByType 指令。此映射會合併到所有強制生效的映射中，覆寫同一個 extension 已存在的任何映射。

例如，以下組態會處理所有 .shtml 檔案，取得伺服器側包括的檔案，然後再使用 mod_deflate 壓縮輸出。

AddOutputFilter INCLUDES;DEFLATE shtml

如果指定超過一個 filter，它們必須以處理內容的順序使用分號分隔。給定 filter 參數時不區分大小寫。

extension 參數不區分大小寫，且可以加上或不加上開頭的句號來指定。檔案名稱可以有 多個副檔名，extension 參數會與每個副檔名進行比較。

請注意，在使用 AddOutputFilter 指令定義 filter 組時，這項定義會取代先前由 AddOutputFilter 指令建立的任何定義。

# Effective filter "DEFLATE"
AddOutputFilter DEFLATE shtml
<Location "/foo">
  # Effective filter "INCLUDES", replacing "DEFLATE"
  AddOutputFilter INCLUDES shtml
</Location>
<Location "/bar">
  # Effective filter "INCLUDES;DEFLATE", replacing "DEFLATE"
  AddOutputFilter INCLUDES;DEFLATE shtml
</Location>
<Location "/bar/baz">
  # Effective filter "BUFFER", replacing "INCLUDES;DEFLATE"
  AddOutputFilter BUFFER shtml
</Location>
<Location "/bar/baz/buz">
  # No effective filter, replacing "BUFFER"
  RemoveOutputFilter shtml
</Location>

相關資訊

• RemoveOutputFilter
• SetOutputFilter

AddType 指令

指令 AddType 將給定的副檔名映射到指定的內容類型。 media-type 是 媒體類型，可用在包含 extension 的檔案名稱上。此映射會加入所有強制生效的映射中，覆寫同一個 extension 已存在的任何映射。

AddType image/gif .gif

或者，要在一個指令中指定多個副檔名

AddType image/jpeg jpeg jpg jpe

extension 參數不區分大小寫，且可以加上或不加上開頭的句號來指定。檔案名稱可以有 多個副檔名，extension 參數會與每個副檔名進行比較。

類似 mod_negotiation 的 LanguagePriority 效果，可用 media-type 的 qs 予以達成。

AddType application/rss+xml;qs=0.8 .xml

這可用於下列情況，例如當要求 Accept: */* 的用戶端實際上無法處理伺服器回傳的內容時。

此指令會主要組態從檔案系統提供的靜態檔案所產生的內容類型。對於靜態檔案之外的資源，回應產生程式通常會指定內容類型，此指令沒有作用。

相關資訊

• ForceType
• mod_negotiation

DefaultLanguage 指令

DefaultLanguage 指令告訴 Apache，不具有明確語言延伸功能 (例如 AddLanguage 所設定的 .fr 或 .de) 的、指令範圍內所有資源 (例如所有由目前 <Directory> 容器涵蓋的資源) 應指定為 language-tag 之 Content-Language。這允許完整目錄樹標記為包含荷蘭語內容，例如，而不必重新命名每個檔案。請注意，不同於使用延伸功能來指定語言，DefaultLanguage 只能指定單一語言。

如果沒有強制實施 DefaultLanguage 指令，且檔案沒有 AddLanguage 所設定的任何語言延伸功能，則不會產生 Content-Language 標頭欄位。

DefaultLanguage en

相關資訊

• mod_negotiation

ModMimeUsePathInfo 指令

ModMimeUsePathInfo 指令用來結合檔名與 `路徑_資訊` URL 元件，來套用 mod_mime 的指令在要求上。預設值為 Off - 因此，`路徑_資訊` 元件會被略過。

當您有虛擬檔案系統時建議使用此指令。

ModMimeUsePathInfo On

如果您對 /index.php/foo.shtml 提出要求，ModMimeUsePathInfo 現在會將輸入的要求視為 /index.php/foo.shtml，而且像是 AddOutputFilter INCLUDES .shtml 的指令會新增 `INCLUDES` 篩選器至要求。若未設定 ModMimeUsePathInfo，則不會新增 INCLUDES 篩選器。此行為會類似地套用在虛擬路徑上，例如由 <Location> 所定義的路徑。

相關資訊

• AcceptPathInfo

MultiviewsMatch 指令

MultiviewsMatch 允許 mod_negotiation 的 Multiviews 功能三種不同的行為。Multiviews 允許對檔案的要求，例如 index.html，符合基本要求之後的任何協商擴充功能，例如 index.html.en、index.html.fr 或 index.html.gz。

NegotiatedOnly 選項提供每個基本名稱後的擴充功能都必須與已辨識的 mod_mime 擴充功能相關聯，以進行內容協商，例如 字元集、內容類型、語言或編碼。這是執行最嚴格、副作用最少的實作，也是預設行為。

若要納入與 Handler 和/或 Filters 關聯的擴充功能，請將 MultiviewsMatch 指令設定為 Handlers、Filters 或兩個選項關鍵字。如果其他所有因素都相同，將會提供最小檔案，例如 在大小 500 位元組的 index.html.cgi 和大小 1000 位元組的 index.html.pl 之間進行決定時，在此範例中 .cgi 檔案會勝出。如果 .asis 檔案與 asis-handler 關聯，則 .asis 檔案使用者可能偏好使用 Handler 選項。

您最後可以允許 Any 擴充功能符合，即使 mod_mime 無法辨識該擴充功能。這可能會導致無法預測的結果，例如提供網頁管理者從未預期會提供的 .old 或 .bak 檔案。

例如，下列設定將允許 handlers 和 filters 參與 Multviews，但會排除未知檔案

MultiviewsMatch Handlers Filters

MultiviewsMatch 不得用於 <Location> 或 <LocationMatch> 區段。

相關資訊

• 選項
• mod_negotiation

RemoveCharset 指令

RemoveCharset 指令會移除具有指定擴充功能的檔案的所有字元集關聯。這允許子目錄中的 .htaccess 檔案復原任何從父目錄或伺服器設定檔繼承的關聯。

extension 引數不分大小寫，而且可以搭配前導句點提供，也可以不搭配前導句點。

RemoveCharset .html .shtml

RemoveEncoding 指令

RemoveEncoding 指令會移除具有指定擴充功能的檔案的所有編碼關聯。這允許子目錄中的 .htaccess 檔案復原任何從父目錄或伺服器設定檔繼承的關聯。其用處範例可能是

AddEncoding x-gzip .gz
AddType text/plain .asc
<Files "*.gz.asc">
    RemoveEncoding .gz
</Files>

導致 foo.gz 標記為使用 gzip 方法編碼，而 foo.gz.asc 標記為未編碼的純文字檔。

extension 引數不分大小寫，而且可以搭配前導句點提供，也可以不搭配前導句點。

RemoveHandler 指令

RemoveHandler 指令移除具有給定副檔名的任何處理常式關聯。這允許子目錄中的 .htaccess 檔案解除任何繼承自父目錄或伺服器設定檔的關聯。它的使用範例可能是

AddHandler server-parsed .html

RemoveHandler .html

這會導致 /foo/bar 目錄中的 .html 檔案會像普通檔案一樣受到處理，而不是視為需要剖析的候選 (請參閱 mod_include 模組)。

extension 引數不分大小寫，而且可以搭配前導句點提供，也可以不搭配前導句點。

RemoveInputFilter 指令

RemoveInputFilter 指令移除具有給定副檔名的任何輸入 過濾器 關聯。這允許子目錄中的 .htaccess 檔案解除任何繼承自父目錄或伺服器設定檔的關聯。

extension 引數不分大小寫，而且可以搭配前導句點提供，也可以不搭配前導句點。

相關資訊

• AddInputFilter
• SetInputFilter

RemoveLanguage 指令

RemoveLanguage 指令移除具有給定副檔名的任何語言關聯。這允許子目錄中的 .htaccess 檔案解除任何繼承自父目錄或伺服器設定檔的關聯。

extension 引數不分大小寫，而且可以搭配前導句點提供，也可以不搭配前導句點。

RemoveOutputFilter 指令

RemoveOutputFilter 指令移除具有給定副檔名的任何輸出 過濾器 關聯。這允許子目錄中的 .htaccess 檔案解除任何繼承自父目錄或伺服器設定檔的關聯。

extension 引數不分大小寫，而且可以搭配前導句點提供，也可以不搭配前導句點。

RemoveOutputFilter shtml

相關資訊

• AddOutputFilter

RemoveType 指令

指令 RemoveType 會移除所有與指定副檔名的檔案相關聯的 媒體類型。這允許子目錄中的 .htaccess 檔案取消繼承自父目錄或伺服器設定檔的任何相關聯。其使用方法的範例可能是

RemoveType .cgi

這將移除 /foo/ 目錄及以下層級中 .cgi 檔案的所有特殊處理，導致包含這些檔案的回應省略 HTTP 內容類型標頭欄位。

extension 引數不分大小寫，而且可以搭配前導句點提供，也可以不搭配前導句點。

TypesConfig 指令

指令 TypesConfig 設定 媒體類型設定檔的位置。 檔案路徑 相對於 ServerRoot。此檔案設定從檔名副檔名到內容類型的預設對應清單。大多數系統管理員使用作業系統提供的 mime.types 檔案，它會將常見的檔名副檔名與在 http://www.iana.org/assignments/media-types/index.html 維護的 IANA 已註冊媒體類型的官方清單以及大量非官方類型做對應。這簡化了 httpd.conf 檔案提供大部分媒體類型定義的功能，而且在需要時可由 AddType 指令覆寫。您不應編輯 mime.types 檔案，因為升級伺服器時可能會將其取代。

此檔案包含行，且其格式為指令 AddType 的引數

副檔名的大小寫沒有關係。空行以及以雜湊符號 (#) 開頭的行會被忽略。空行是為了完整性 (mime.types 檔案)。Apache httpd 仍可以使用 mod_mime_magic 判斷這些類型。