<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<section id="mbstring.installation">
  &reftitle.install;
  <para>
   <literal>mbstring</literal> is a non-default extension. This means it
   is not enabled by default. You must explicitly enable the module with
   the <literal>configure</literal> option. See the
   <link linkend="install">Install</link> section for details.
  </para>
  <simpara>
   The following configure options are related to the
   <literal>mbstring</literal> module.
  </simpara>
  <para>
   <itemizedlist>
    <listitem>
     <para>
      <option role="configure">--enable-mbstring=LANG</option>: Enable
      <literal>mbstring</literal> functions. This option is
      required to use <literal>mbstring</literal> functions.
     </para>
     <para>
      As of PHP 4.3.0, <literal>mbstring</literal> extension provides
      enhanced support for Simplified Chinese, Traditional Chinese,
      Korean, and Russian in addition to Japanese.
      To enable that feature, you will have to supply either one of the
      following options to the <literal>LANG</literal> parameter; 
      <option role="configure">--enable-mbstring=cn</option> for Simplified Chinese support,
      <option role="configure">--enable-mbstring=tw</option> for Traditional Chinese support, 
      <option role="configure">--enable-mbstring=kr</option> for Korean support, 
      <option role="configure">--enable-mbstring=ru</option> for Russian support, and
      <option role="configure">--enable-mbstring=ja</option> for Japanese support.
     </para>
     <para>
      Also <option role="configure">--enable-mbstring=all</option> is
      convenient for you to enable all the supported languages listed above.
     </para>
     <note>
      <para>
       Japanese language support is also enabled by
       <option role="configure">--enable-mbstring</option> without any options
       for the sake of backwards compatibility.
      </para>
     </note>
    </listitem>
    <listitem>
     <para>
      <option role="configure">--enable-mbstr-enc-trans</option> :
      Enable HTTP input character encoding conversion using
      <literal>mbstring</literal> conversion engine. If this
      feature is enabled, HTTP input character encoding may be
      converted to <literal>mbstring.internal_encoding</literal>
      automatically.
     </para>
     <note>
      <para>
       As of PHP 4.3.0, the option 
       <option role="configure">--enable-mbstr-enc-trans</option>
       was eliminated and replaced with the runtime setting
       <literal>mbstring.encoding_translation</literal>.
       HTTP input character encoding conversion is enabled
       when this is set to <literal>On</literal>
       (the default is <literal>Off</literal>).
      </para>
     </note>
    </listitem>
    <listitem>
     <para>
      <option role="configure">--enable-mbregex</option>: Enable
      regular expression functions with multibyte character support.
     </para>
    </listitem>
   </itemizedlist>
  </para>
</section>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->