Apache 模組 mod_charset_lite

可用語言: en | fr | ko

描述	指定字元集轉換或重新編碼
狀態	擴充
模組識別碼	charset_lite_module
原始檔案	mod_charset_lite.c

摘要

mod_charset_lite 允許伺服器在將回應傳送給用戶端之前變更回應的字元集。在 EBCDIC 環境中，Apache 永遠會將 HTTP 協定內容（例如回應標頭）從 Apache 進程區域設定的編碼頁面轉譯成 ISO-8859-1，而不包含回應本文。在任何環境中，mod_charset_lite 可用於指定是否要針對回應本文進行翻譯。例如，如果檔案儲存在 EBCDIC，mod_charset_lite 會在將檔案傳送給用戶端之前將檔案翻譯成 ISO-8859-1。

此模組提供由 Russian Apache 及其關聯的 mod_charset 所實作的設定機制中的一小部分。

主題

常見問題

錯誤修正清單

請參閱

註解

常見問題

無效的字元集名稱

在 CharsetSourceEnc 及 CharsetDefault 的字元集名稱參數，必須使用 APR 在部署 mod_charset_lite 的系統上所使用的轉換機制。這些字元集名稱並未標準化，通常也不同於 http 標頭中所使用的對應值。目前，APR 只可以使用 iconv(3)，因此你可以使用 iconv(1) 程式，如下進行測試字元集名稱：

iconv -f charsetsourceenc-value -t charsetdefault-value

內容字元集和轉換規則之間不符

如果翻譯規則對內容沒有意義，翻譯可能會因各種方式失敗，包括

翻譯機制可能會傳回錯誤的回覆代碼，並且連線會中止。
當翻譯機制無法翻譯輸入緩衝區時，它可能會在輸出緩衝區中靜默地插入特殊字元（例如，問號）。

CharsetDefault 指令

描述	要翻譯成的字元集
語法	`CharsetDefault charset`
內容	伺服器設定檔、虛擬主機、目錄、.htaccess
覆寫	FileInfo
狀態	擴充
模組	mod_charset_lite

CharsetDefault 指令指定應將關聯容器中的內容翻譯成什麼字元集。

charset 參數的值必定是 APR 中的字元集支援認可為有效字元集名稱。這通常表示它必須由 iconv 支援。

範例

<Directory "/export/home/trawick/apacheinst/htdocs/convert">
    CharsetSourceEnc  UTF-16BE
    CharsetDefault    ISO-8859-1
</Directory>

在 CharsetSourceEnc 和 CharsetDefault 中指定相同的字元集，就會停用翻譯。字元集不一定要和回應的字元集相符，但它必須是系統上的有效字元集。

CharsetOptions 指令

描述	設定字元集翻譯行為
語法	`CharsetOptions 選項 [選項] ...`
預設值	`CharsetOptions ImplicitAdd`
內容	伺服器設定檔、虛擬主機、目錄、.htaccess
覆寫	FileInfo
狀態	擴充
模組	mod_charset_lite

CharsetOptions 指令設定 mod_charset_lite 的某些行為。選項可以是

ImplicitAdd | NoImplicitAdd: ImplicitAdd 關鍵字指定 mod_charset_lite 應該在設定檔指定字元集應該進行翻譯時，隱含地插入其濾網。如果使用 AddOutputFilter 指令明確設定濾網鏈，則應該指定 NoImplicitAdd，以便 mod_charset_lite 無法新增其濾網。
TranslateAllMimeTypes | NoTranslateAllMimeTypes: 通常，mod_charset_lite 僅會對一小部分可能的 MIME 類型執行翻譯。當對特定組態區段指定 TranslateAllMimeTypes 關鍵字時，翻譯會執行，而不用考慮 MIME 類型。

CharsetSourceEnc 指令

描述	檔案的來源字元集
語法	`CharsetSourceEnc charset`
內容	伺服器設定檔、虛擬主機、目錄、.htaccess
覆寫	FileInfo
狀態	擴充
模組	mod_charset_lite

CharsetSourceEnc 指令指定關聯容器中檔案的來源字元集。