<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> <title>Installation</title> </head> <body><div class="manualnavbar" style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="mbstring.requirements.html">Requirements</a></div> <div class="next" style="text-align: right; float: right;"><a href="mbstring.configuration.html">Runtime Configuration</a></div> <div class="up"><a href="mbstring.setup.html">Installing/Configuring</a></div> <div class="home"><a href="index.html">PHP Manual</a></div> </div><hr /><div id="mbstring.installation" class="section"> <h2 class="title">Installation</h2> <p class="para"> <em>mbstring</em> is a non-default extension. This means it is not enabled by default. You must explicitly enable the module with the <em>configure</em> option. See the <a href="install.html" class="link">Install</a> section for details. </p> <p class="simpara"> The following configure options are related to the <em>mbstring</em> module. </p> <p class="para"> <ul class="itemizedlist"> <li class="listitem"> <p class="para"> <strong class="option configure">--enable-mbstring</strong> : Enable <em>mbstring</em> functions. This option is required to use <em>mbstring</em> functions. </p> <p class="para"> <span class="productname">libmbfl</span> is necesarry for <em>mbstring</em>. <span class="productname">libmbfl</span> is bundled with <em>mbstring</em>. If <span class="productname">libmbfl</span> is already installed on the system, <strong class="option configure">--with-libmbfl[=DIR]</strong> can be specified to use the installed library. </p> <p class="para"> As of PHP 4.3.0, <em>mbstring</em> extension provides enhanced support for Simplified Chinese, Traditional Chinese, Korean, and Russian in addition to Japanese. </p> <p class="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 <em>LANG</em> parameter of <strong class="option configure">--enable-mbstring=LANG</strong> ; <strong class="option configure">--enable-mbstring=cn</strong> for Simplified Chinese support, <strong class="option configure">--enable-mbstring=tw</strong> for Traditional Chinese support, <strong class="option configure">--enable-mbstring=kr</strong> for Korean support, <strong class="option configure">--enable-mbstring=ru</strong> for Russian support, and <strong class="option configure">--enable-mbstring=ja</strong> for Japanese support (default). To enable all supported encoding, use <strong class="option configure">--enable-mbstring=all</strong> . </p> <blockquote class="note"><p><strong class="note">Note</strong>: <p class="para"> As of PHP 4.3.4, all supported encoding by <span class="productname">libmbfl</span> is enabled with <strong class="option configure">--enable-mbstring</strong> . </p> </p></blockquote> </li> <li class="listitem"> <p class="para"> <strong class="option configure">--enable-mbstr-enc-trans</strong> : Enable HTTP input character encoding conversion using <em>mbstring</em> conversion engine. If this feature is enabled, HTTP input character encoding may be converted to <em>mbstring.internal_encoding</em> automatically. </p> <blockquote class="note"><p><strong class="note">Note</strong>: <p class="para"> As of PHP 4.3.0, the option <strong class="option configure">--enable-mbstr-enc-trans</strong> was eliminated and replaced with the runtime setting <em>mbstring.encoding_translation</em>. HTTP input character encoding conversion is enabled when this is set to <em>On</em> (the default is <em>Off</em>). </p> </p></blockquote> </li> <li class="listitem"> <p class="para"> <strong class="option configure">--disable-mbregex</strong> : Disable regular expression functions with multibyte character support. </p> </li> </ul> </p> </div><hr /><div class="manualnavbar" style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="mbstring.requirements.html">Requirements</a></div> <div class="next" style="text-align: right; float: right;"><a href="mbstring.configuration.html">Runtime Configuration</a></div> <div class="up"><a href="mbstring.setup.html">Installing/Configuring</a></div> <div class="home"><a href="index.html">PHP Manual</a></div> </div></body></html>