hirokawa Tue Sep 17 12:56:29 2002 EDT
Modified files:
/phpdoc/en/reference/mbstring ini.xml reference.xml
Log:
added new mbstring option.
Index: phpdoc/en/reference/mbstring/ini.xml
diff -u phpdoc/en/reference/mbstring/ini.xml:1.3
phpdoc/en/reference/mbstring/ini.xml:1.4
--- phpdoc/en/reference/mbstring/ini.xml:1.3 Sun Sep 15 11:15:53 2002
+++ phpdoc/en/reference/mbstring/ini.xml Tue Sep 17 12:56:29 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<section id="mbstring.configuration">
&reftitle.runtime;
&extension.runtime;
@@ -69,6 +69,24 @@
<para>
Here is a short explanation of the configuration directives.
<itemizedlist>
+ <listitem id="ini.mbstring.language">
+ <simpara>
+ <literal>mbstring.language</literal> defines
+ default language used in mbstring.
+ Note that this option defines
+ <literal>mbstring.interanl_encoding</literal>
+ and <literal>mbstring.interanl_encoding</literal>
+ should be placed after <literal>mbstring.language</literal>
+ in &php.ini;
+ </simpara>
+ </listitem>
+ <listitem id="ini.mbstring.encoding-translation">
+ <simpara>
+ <literal>mbstring.encoding_translation</literal> enables
+ HTTP input character encoding detection and translation into
+ internal chatacter encoding.
+ </simpara>
+ </listitem>
<listitem id="ini.mbstring.internal-encoding">
<simpara>
<literal>mbstring.internal_encoding</literal> defines default
@@ -138,10 +156,17 @@
<title>&php.ini; setting example</title>
<programlisting>
<![CDATA[
+; Set default language
+mbstring.language = English; Set default language to English (default)
+mbstring.language = Japanese; Set default language to Japanese
+
;; Set default internal encoding
;; Note: Make sure to use character encoding works with PHP
mbstring.internal_encoding = UTF-8 ; Set internal encoding to UTF-8
+;; HTTP input encoding translation is enabled.
+mbstring.encoding_translation = On
+
;; Set default HTTP input character encoding
;; Note: Script cannot change http_input setting.
mbstring.http_input = pass ; No conversion.
@@ -177,6 +202,12 @@
;; Set HTTP header charset
default_charset = EUC-JP
+;; Set default language to Japanese
+mbstring.language = Japanese
+
+;; HTTP input encoding translation is enabled.
+mbstring.encoding_translation = On
+
;; Set HTTP input encoding conversion to auto
mbstring.http_input = auto
@@ -205,6 +236,9 @@
;; Set HTTP header charset
default_charset = Shift_JIS
+
+;; Set default language to Japanese
+mbstring.language = Japanese
;; Set http input encoding conversion to auto
mbstring.http_input = auto
Index: phpdoc/en/reference/mbstring/reference.xml
diff -u phpdoc/en/reference/mbstring/reference.xml:1.5
phpdoc/en/reference/mbstring/reference.xml:1.6
--- phpdoc/en/reference/mbstring/reference.xml:1.5 Sat Sep 14 17:19:27 2002
+++ phpdoc/en/reference/mbstring/reference.xml Tue Sep 17 12:56:29 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
<reference id="ref.mbstring">
<title>Multi-Byte String Functions</title>
<titleabbrev>Multi-Byte String</titleabbrev>
@@ -115,6 +115,30 @@
<literal>mbstring</literal> functions. This option is
required to use <literal>mbstring</literal> functions.
</para>
+ <note>
+ <para>
+ As of PHP 4.3.0, the option
+ <option role="configure">--enable-mbstring</option>
+ will be enabled by default and replaced with
+ <option role="configure">--with-mbstring[=LANG]</option>
+ to support Chinese, Korean and Russian language support.
+ Japanese character encoding is supported by default.
+ If <option role="configure">--with-mbstring=cn</option>
+ is used, simplified chinese encoding will be supported.
+ If <option role="configure">--with-mbstring=tw</option>
+ is used, traditional chinese encoding will be supported.
+ If <option role="configure">--with-mbstring=kr</option>
+ is used, korean encoding will be supported.
+ If <option role="configure">--with-mbstring=ru</option>
+ is used, russian encoding will be supported.
+ If <option role="configure">--with-mbstring=all</option>
+ is added, all supported character encoding in mbstring
+ will be enabled, but the binary size of PHP will be
+ maximized because of huge Unicode character maps.
+ Note that Chinese, Korean and Russian encoding is
+ experimentally supported in PHP 4.3.0.
+ </para>
+ </note>
</listitem>
<listitem>
<para>
@@ -125,6 +149,17 @@
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>
+ will be eliminated and replaced with
+ <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>
@@ -166,7 +201,8 @@
<simpara>
HTTP Input
</simpara>
- <para> There is no way to control HTTP input character
+ <para>
+ There is no way to control HTTP input character
conversion from PHP script. To disable HTTP input character
conversion, it has to be done in &php.ini;.
<example>
@@ -177,6 +213,8 @@
<![CDATA[
;; Disable HTTP Input conversion
mbstring.http_input = pass
+;; Disable HTTP Input conversion (PHP 4.3.0 or higher)
+mbstring.encoding_translation = Off
]]>
</programlisting>
</example>
@@ -285,6 +323,18 @@
<literal>byte4le</literal>, <literal>BASE64</literal>,
<literal>7bit</literal>, <literal>8bit</literal> and
<literal>UTF7-IMAP</literal>.
+ </para>
+ <para>
+ As of PHP 4.3.0, the following character encoding support will be added
+ experimentaly :
+ <literal>EUC-CN</literal>, <literal>CP936</literal>, <literal>HZ</literal>,
+ <literal>EUC-TW</literal>, <literal>CP950</literal>, <literal>BIG-5</literal>,
+ <literal>EUC-KR</literal>, <literal>UHC</literal> (<literal>CP949</literal>),
+ <literal>ISO-2022-KR</literal>,
+ <literal>Windows-1251</literal> (<literal>CP1251</literal>),
+ <literal>Windows-1252</literal> (<literal>CP1252</literal>),
+ <literal>CP866</literal>,
+ <literal>KOI8-R</literal>.
</para>
<para>
&php.ini; entry, which accepts encoding name,
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
