mirror of
https://github.com/apache/httpd.git
synced 2025-07-19 02:42:17 +03:00
5e8ac7dd19
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@96159 13f79535-47bb-0310-9956-ffa450edef68
122 lines
10 KiB
Plaintext
122 lines
10 KiB
Plaintext
<html xmlns="http://www.w3.org/TR/xhtml1/strict"><head><!--
|
|
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
|
This file is generated from xml source: DO NOT EDIT
|
|
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
|
--><title>mod_charset_lite- Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_charset_lite</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td nowrap="nowrap" valign="top"><span class="help">Description:</span></td><td>Specify character set translation or recoding</td></tr><tr><td nowrap="nowrap"><a href="module-dict.html#Status" class="help">Status:</a></td><td>Experimental</td></tr><tr><td nowrap="nowrap"><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>charset_lite_module</td></tr></table></td></tr></table><h2>Summary</h2>
|
|
<p>This is an <strong>experimental</strong> module and should
|
|
be used with care. Experiment with your
|
|
<code>mod_charset_lite</code> configuration to ensure that it
|
|
performs the desired function.</p>
|
|
|
|
<p><code><a href="mod_charset_lite.html">mod_charset_lite</a></code> allows the administrator to
|
|
specify the source character set of objects as well as the
|
|
character set they should be translated into before sending to the
|
|
client. <code><a href="mod_charset_lite.html">mod_charset_lite</a></code> does not translate the
|
|
data itself but instead tells Apache what translation to
|
|
perform. <code><a href="mod_charset_lite.html">mod_charset_lite</a></code> is applicable to EBCDIC
|
|
and ASCII host environments. In an EBCDIC environment, Apache
|
|
normally translates text content from the code page of the Apache
|
|
process locale to ISO-8859-1. <code><a href="mod_charset_lite.html">mod_charset_lite</a></code>
|
|
can be used to specify that a different translation is to be
|
|
performed. In an ASCII environment, Apache normally performs no
|
|
translation, so <code><a href="mod_charset_lite.html">mod_charset_lite</a></code> is needed in
|
|
order for any translation to take place.</p>
|
|
|
|
<p>This module provides a small subset of configuration
|
|
mechanisms implemented by Russian Apache and its associated
|
|
<code>mod_charset</code>.</p>
|
|
<h2>Directives</h2><ul><li><a href="#charsetdefault">CharsetDefault</a></li><li><a href="#charsetoptions">CharsetOptions</a></li><li><a href="#charsetsourceenc">CharsetSourceEnc</a></li></ul><h2>Common Problems</h2>
|
|
|
|
<h3>Invalid character set names</h3>
|
|
|
|
<p>The character set name parameters of <a href="#charsetsourceenc" class="directive"><code class="directive">CharsetSourceEnc</code></a> and
|
|
<a href="#charsetdefault" class="directive"><code class="directive">CharsetDefault</code></a>
|
|
must be acceptable to the translation mechanism used by APR on the
|
|
system where <code><a href="mod_charset_lite.html">mod_charset_lite</a></code> is deployed. These
|
|
character set names are not standardized and are usually not the
|
|
same as the corresponding values used in http headers. Currently,
|
|
APR can only use iconv(3), so you can easily test your character
|
|
set names using the iconv(1) program, as follows:</p>
|
|
<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
|
|
iconv -f charsetsourceenc-value -t charsetdefault-value
|
|
</code></td></tr></table></blockquote>
|
|
|
|
|
|
<h3>Mismatch between character set of content and translation
|
|
rules</h3>
|
|
|
|
<p>If the translation rules don't make sense for the content,
|
|
translation can fail in various ways, including:</p>
|
|
|
|
<ul>
|
|
<li>The translation mechanism may return a bad return code,
|
|
and the connection will be aborted.</li>
|
|
|
|
<li>The translation mechanism may silently place special
|
|
characters (e.g., question marks) in the output buffer when
|
|
it cannot translate the input buffer.</li>
|
|
</ul>
|
|
|
|
<hr/><h2><a name="CharsetDefault">CharsetDefault</a> <a name="charsetdefault">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td nowrap="nowrap"><strong>Description: </strong></td><td>Charset to translate into</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>CharsetDefault <em>charset</em></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Override" class="help">Override:</a></td><td>FileInfo</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Experimental</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_charset_lite</td></tr></table></td></tr></table>
|
|
<p>The <code class="directive">CharsetDefault</code> directive specifies the
|
|
charset that content in the associated container should be
|
|
translated to.</p>
|
|
|
|
<p>The value of the <em>charset</em> argument must be accepted
|
|
as a valid character set name by the character set support in
|
|
APR. Generally, this means that it must be supported by
|
|
iconv.</p>
|
|
|
|
<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><p align="center"><strong>Example</strong></p><code>
|
|
<Directory "/export/home/trawick/apacheinst/htdocs/convert"><br>
|
|
CharsetSourceEnc UTF-16BE<br>
|
|
CharsetDefault ISO8859-1<br>
|
|
</Directory>
|
|
</code></td></tr></table></blockquote>
|
|
<hr/><h2><a name="CharsetOptions">CharsetOptions</a> <a name="charsetoptions">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td nowrap="nowrap"><strong>Description: </strong></td><td>Configures charset tranlation behavior</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>CharsetOptions <em>option</em> [<em>option</em>] ...</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>CharsetOptions DebugLevel=0
|
|
NoImplicitAdd</code></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Override" class="help">Override:</a></td><td>FileInfo</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Experimental</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_charset_lite</td></tr></table></td></tr></table>
|
|
<p>The <code class="directive">CharsetOptions</code> directive configures certain
|
|
behaviors of <code><a href="mod_charset_lite.html">mod_charset_lite</a></code>. <em>Option</em> can
|
|
be one of</p>
|
|
|
|
<dl>
|
|
<dt>DebugLevel=<em>n</em></dt>
|
|
|
|
<dd>The <code>DebugLevel</code> keyword allows you to specify
|
|
the level of debug messages generated by
|
|
<code><a href="mod_charset_lite.html">mod_charset_lite</a></code>. By default, no messages are
|
|
generated. This is equivalent to <code>DebugLevel=0</code>.
|
|
With higher numbers, more debug messages are generated, and
|
|
server performance will be degraded. The actual meanings of
|
|
the numeric values are described with the definitions of the
|
|
DBGLVL_ constants near the beginning of
|
|
<code>mod_charset_lite.c</code>.</dd>
|
|
|
|
<dt>ImplicitAdd | NoImplicitAdd</dt>
|
|
|
|
<dd>The <code>ImplicitAdd</code> keyword specifies that
|
|
<code><a href="mod_charset_lite.html">mod_charset_lite</a></code> should implicitly insert its
|
|
filter when the configuration specifies that the character
|
|
set of content should be translated. If the filter chain is
|
|
explicitly configured using the AddOutputFilter directive,
|
|
<code>NoImplicitAdd</code> should be specified so that
|
|
<code><a href="mod_charset_lite.html">mod_charset_lite</a></code> doesn't add its filter.</dd>
|
|
</dl>
|
|
<hr/><h2><a name="CharsetSourceEnc">CharsetSourceEnc</a> <a name="charsetsourceenc">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td nowrap="nowrap"><strong>Description: </strong></td><td>Source charset of files</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>CharsetSourceEnc <em>charset</em></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Override" class="help">Override:</a></td><td>FileInfo</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Experimental</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_charset_lite</td></tr></table></td></tr></table>
|
|
<p>The <code class="directive">CharsetSourceEnc</code> directive specifies the
|
|
source charset of files in the associated container.</p>
|
|
|
|
<p>The value of the <em>charset</em> argument must be accepted
|
|
as a valid character set name by the character set support in
|
|
APR. Generally, this means that it must be supported by
|
|
iconv.</p>
|
|
|
|
<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><p align="center"><strong>example</strong></p><code>
|
|
<Directory "/export/home/trawick/apacheinst/htdocs/convert"><br>
|
|
CharsetSourceEnc UTF-16BE<br>
|
|
CharsetDefault ISO8859-1<br>
|
|
</Directory>
|
|
</code></td></tr></table></blockquote>
|
|
<p>The character set names in this example work with the iconv
|
|
translation support in Solaris 8.</p>
|
|
<hr/></blockquote><h3 align="center">Apache HTTP Server Version 2.0</h3><a href="./"><img src="../images/index.gif" alt="Index"/></a><a href="../"><img src="../images/home.gif" alt="Home"/></a></body></html> |