php-doc-en/reference/mbstring/configure.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.7 $ -->
<section xml:id="mbstring.installation" xmlns="http://docbook.org/ns/docbook">
  &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</option>: Enable
      <literal>mbstring</literal> functions. This option is
      required to use <literal>mbstring</literal> functions.
     </para>
     <para>
      <productname>libmbfl</productname> is necesarry for <literal>mbstring</literal>.
      <productname>libmbfl</productname> is bundled with <literal>mbstring</literal>.
      If <productname>libmbfl</productname> is already installed on the system,
      <option role="configure">--with-libmbfl[=DIR]</option> can be specified to use 
      the installed library.
     </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.
     </para>
     <para>
      For PHP 4.3.3 or before, 
      To enable that feature, you will have to supply either one of the
      following options to the <literal>LANG</literal> parameter
      of <option role="configure">--enable-mbstring=LANG</option>; 
      <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 (default).
       To enable all supported encoding, use <option role="configure">--enable-mbstring=all</option>.
     </para>
     <note>
      <para>
       As of PHP 4.3.4, 
       all supported encoding by <productname>libmbfl</productname> is enabled
       with <option role="configure">--enable-mbstring</option>.
      </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">--disable-mbregex</option>: Disable
      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
-->