cvs: phpdoc /en/reference/mbstring ini.xml reference.xml
| From: | Friedhelm Betz | Date: | Sat, 14 Sep 2002 21:19:27 +0000 |
| Subject: | cvs: phpdoc /en/reference/mbstring ini.xml reference.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969348644@lists.php.net to get a copy of this message | ||
betz Sat Sep 14 17:19:27 2002 EDT
Added files:
/phpdoc/en/reference/mbstring ini.xml
Modified files:
/phpdoc/en/reference/mbstring reference.xml
Log:
ini.xml added, linked in reference
Index: phpdoc/en/reference/mbstring/reference.xml diff -u phpdoc/en/reference/mbstring/reference.xml:1.4 phpdoc/en/reference/mbstring/reference.xml:1.5 --- phpdoc/en/reference/mbstring/reference.xml:1.4 Sat Aug 10 00:09:10 2002 +++ phpdoc/en/reference/mbstring/reference.xml Sat Sep 14 17:19:27 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <reference id="ref.mbstring"> <title>Multi-Byte String Functions</title> <titleabbrev>Multi-Byte String</titleabbrev> @@ -136,152 +136,8 @@ </para> </section> - <section id="mbstring.configuration"> - &reftitle.runtime; - <para> - <itemizedlist> - <listitem> - <simpara> - <literal>mbstring.internal_encoding</literal> defines default - internal character encoding. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>mbstring.http_input</literal> defines default HTTP - input character encoding. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>mbstring.http_output</literal> defines default HTTP - output character encoding. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>mbstring.detect_order</literal> defines default - character code detection order. See also - <function>mb_detect_order</function>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>mbstring.substitute_character</literal> defines - character to substitute for invalid character encoding. - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - Web Browsers are supposed to use the same character encoding - when submitting form. However, browsers may not use the same - character encoding. See <function>mb_http_input</function> to - detect character encoding used by browsers. - </para> - <para> - If <literal>enctype</literal> is set to - <literal>multipart/form-data</literal> in HTML forms, - <literal>mbstring</literal> does not convert character encoding - in POST data. The user must convert them in the script, if - conversion is needed. - </para> - <para> - Although, browsers are smart enough to detect character encoding - in HTML. <literal>charset</literal> is better to be set in HTTP - header. Change <literal>default_charset</literal> according to - character encoding. - </para> - <para> - <example> - <title>&php.ini; setting example</title> - <programlisting> -<![CDATA[ -;; 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 - -;; Set default HTTP input character encoding -;; Note: Script cannot change http_input setting. -mbstring.http_input = pass ; No conversion. -mbstring.http_input = auto ; Set HTTP input to auto - ; "auto" is expanded to "ASCII,JIS,UTF-8,EUC-JP,SJIS" -mbstring.http_input = SJIS ; Set HTTP2 input to SJIS -mbstring.http_input = UTF-8,SJIS,EUC-JP ; Specify order - -;; Set default HTTP output character encoding -mbstring.http_output = pass ; No conversion -mbstring.http_output = UTF-8 ; Set HTTP output encoding to UTF-8 + &reference.mbstring.ini; -;; Set default character encoding detection order -mbstring.detect_order = auto ; Set detect order to auto -mbstring.detect_order = ASCII,JIS,UTF-8,SJIS,EUC-JP ; Specify order - -;; Set default substitute character -mbstring.substitute_character = 12307 ; Specify Unicode value -mbstring.substitute_character = none ; Do not print character -mbstring.substitute_character = long ; Long Example: U+3000,JIS+7E7E -]]> - </programlisting> - </example> - </para> - <para> - <example> - <title>&php.ini; setting for <literal>EUC-JP</literal> users</title> - <programlisting> -<![CDATA[ -;; Disable Output Buffering -output_buffering = Off - -;; Set HTTP header charset -default_charset = EUC-JP - -;; Set HTTP input encoding conversion to auto -mbstring.http_input = auto - -;; Convert HTTP output to EUC-JP -mbstring.http_output = EUC-JP - -;; Set internal encoding to EUC-JP -mbstring.internal_encoding = EUC-JP - -;; Do not print invalid characters -mbstring.substitute_character = none -]]> - </programlisting> - </example> - </para> - <para> - <example> - <title>&php.ini; setting for <literal>SJIS</literal> users</title> - <programlisting> -<![CDATA[ -;; Enable Output Buffering -output_buffering = On - -;; Set mb_output_handler to enable output conversion -output_handler = mb_output_handler - -;; Set HTTP header charset -default_charset = Shift_JIS - -;; Set http input encoding conversion to auto -mbstring.http_input = auto - -;; Convert to SJIS -mbstring.http_output = SJIS - -;; Set internal encoding to EUC-JP -mbstring.internal_encoding = EUC-JP - -;; Do not print invalid characters -mbstring.substitute_character = none -]]> - </programlisting> - </example> - </para> - </section> - <section id="mbstring.resources"> &reftitle.resources; &no.resource; Index: phpdoc/en/reference/mbstring/ini.xml +++ phpdoc/en/reference/mbstring/ini.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <section id="mbstring.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> <title>Multi-Byte String configuration options</title> <tgroup cols="3"> <thead> <row> <entry>Name</entry> <entry>Default</entry> <entry>Changeable</entry> </row> </thead> <tbody> <row> <entry>mbstring.language</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>mbstring.detect_order</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>mbstring.http_input</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>mbstring.http_output</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>mbstring.internal_encoding</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>mbstring.script_encoding</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>mbstring.substitute_character</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>mbstring.func_overload</entry> <entry>"0"</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>mbstring.encoding_translation</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> </tbody> </tgroup> </table> For further details and definition of the PHP_INI_* constants see <function>ini_set</function>. </para> <para> Here is a short explanation of the configuration directives. <itemizedlist> <listitem id="ini.mbstring.internal-encoding"> <simpara> <literal>mbstring.internal_encoding</literal> defines default internal character encoding. </simpara> </listitem> <listitem id="ini.mbstring.http-input"> <simpara> <literal>mbstring.http_input</literal> defines default HTTP input character encoding. </simpara> </listitem> <listitem id="ini.mbstring.http-output"> <simpara> <literal>mbstring.http_output</literal> defines default HTTP output character encoding. </simpara> </listitem> <listitem id="ini.mbstring.detect-order"> <simpara> <literal>mbstring.detect_order</literal> defines default character code detection order. See also <function>mb_detect_order</function>. </simpara> </listitem> <listitem id="ini.mbstring.substitute-character"> <simpara> <literal>mbstring.substitute_character</literal> defines character to substitute for invalid character encoding. </simpara> </listitem> </itemizedlist> </para> <para> Web Browsers are supposed to use the same character encoding when submitting form. However, browsers may not use the same character encoding. See <function>mb_http_input</function> to detect character encoding used by browsers. </para> <para> If <literal>enctype</literal> is set to <literal>multipart/form-data</literal> in HTML forms, <literal>mbstring</literal> does not convert character encoding in POST data. The user must convert them in the script, if conversion is needed. </para> <para> Although, browsers are smart enough to detect character encoding in HTML. <literal>charset</literal> is better to be set in HTTP header. Change <literal>default_charset</literal> according to character encoding. </para> <para> <example> <title>&php.ini; setting example</title> <programlisting> <![CDATA[ ;; 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 ;; Set default HTTP input character encoding ;; Note: Script cannot change http_input setting. mbstring.http_input = pass ; No conversion. mbstring.http_input = auto ; Set HTTP input to auto ; "auto" is expanded to "ASCII,JIS,UTF-8,EUC-JP,SJIS" mbstring.http_input = SJIS ; Set HTTP2 input to SJIS mbstring.http_input = UTF-8,SJIS,EUC-JP ; Specify order ;; Set default HTTP output character encoding mbstring.http_output = pass ; No conversion mbstring.http_output = UTF-8 ; Set HTTP output encoding to UTF-8 ;; Set default character encoding detection order mbstring.detect_order = auto ; Set detect order to auto mbstring.detect_order = ASCII,JIS,UTF-8,SJIS,EUC-JP ; Specify order ;; Set default substitute character mbstring.substitute_character = 12307 ; Specify Unicode value mbstring.substitute_character = none ; Do not print character mbstring.substitute_character = long ; Long Example: U+3000,JIS+7E7E ]]> </programlisting> </example> </para> <para> <example> <title>&php.ini; setting for <literal>EUC-JP</literal> users</title> <programlisting> <![CDATA[ ;; Disable Output Buffering output_buffering = Off ;; Set HTTP header charset default_charset = EUC-JP ;; Set HTTP input encoding conversion to auto mbstring.http_input = auto ;; Convert HTTP output to EUC-JP mbstring.http_output = EUC-JP ;; Set internal encoding to EUC-JP mbstring.internal_encoding = EUC-JP ;; Do not print invalid characters mbstring.substitute_character = none ]]> </programlisting> </example> </para> <para> <example> <title>&php.ini; setting for <literal>SJIS</literal> users</title> <programlisting> <![CDATA[ ;; Enable Output Buffering output_buffering = On ;; Set mb_output_handler to enable output conversion output_handler = mb_output_handler ;; Set HTTP header charset default_charset = Shift_JIS ;; Set http input encoding conversion to auto mbstring.http_input = auto ;; Convert to SJIS mbstring.http_output = SJIS ;; Set internal encoding to EUC-JP mbstring.internal_encoding = EUC-JP ;; Do not print invalid characters mbstring.substitute_character = none ]]> </programlisting> </example> </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 -->
Index: phpdoc/en/reference/mbstring/reference.xml diff -u phpdoc/en/reference/mbstring/reference.xml:1.4 phpdoc/en/reference/mbstring/reference.xml:1.5 --- phpdoc/en/reference/mbstring/reference.xml:1.4 Sat Aug 10 00:09:10 2002 +++ phpdoc/en/reference/mbstring/reference.xml Sat Sep 14 17:19:27 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <reference id="ref.mbstring"> <title>Multi-Byte String Functions</title> <titleabbrev>Multi-Byte String</titleabbrev> @@ -136,152 +136,8 @@ </para> </section> - <section id="mbstring.configuration"> - &reftitle.runtime; - <para> - <itemizedlist> - <listitem> - <simpara> - <literal>mbstring.internal_encoding</literal> defines default - internal character encoding. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>mbstring.http_input</literal> defines default HTTP - input character encoding. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>mbstring.http_output</literal> defines default HTTP - output character encoding. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>mbstring.detect_order</literal> defines default - character code detection order. See also - <function>mb_detect_order</function>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>mbstring.substitute_character</literal> defines - character to substitute for invalid character encoding. - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - Web Browsers are supposed to use the same character encoding - when submitting form. However, browsers may not use the same - character encoding. See <function>mb_http_input</function> to - detect character encoding used by browsers. - </para> - <para> - If <literal>enctype</literal> is set to - <literal>multipart/form-data</literal> in HTML forms, - <literal>mbstring</literal> does not convert character encoding - in POST data. The user must convert them in the script, if - conversion is needed. - </para> - <para> - Although, browsers are smart enough to detect character encoding - in HTML. <literal>charset</literal> is better to be set in HTTP - header. Change <literal>default_charset</literal> according to - character encoding. - </para> - <para> - <example> - <title>&php.ini; setting example</title> - <programlisting> -<![CDATA[ -;; 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 - -;; Set default HTTP input character encoding -;; Note: Script cannot change http_input setting. -mbstring.http_input = pass ; No conversion. -mbstring.http_input = auto ; Set HTTP input to auto - ; "auto" is expanded to "ASCII,JIS,UTF-8,EUC-JP,SJIS" -mbstring.http_input = SJIS ; Set HTTP2 input to SJIS -mbstring.http_input = UTF-8,SJIS,EUC-JP ; Specify order - -;; Set default HTTP output character encoding -mbstring.http_output = pass ; No conversion -mbstring.http_output = UTF-8 ; Set HTTP output encoding to UTF-8 + &reference.mbstring.ini; -;; Set default character encoding detection order -mbstring.detect_order = auto ; Set detect order to auto -mbstring.detect_order = ASCII,JIS,UTF-8,SJIS,EUC-JP ; Specify order - -;; Set default substitute character -mbstring.substitute_character = 12307 ; Specify Unicode value -mbstring.substitute_character = none ; Do not print character -mbstring.substitute_character = long ; Long Example: U+3000,JIS+7E7E -]]> - </programlisting> - </example> - </para> - <para> - <example> - <title>&php.ini; setting for <literal>EUC-JP</literal> users</title> - <programlisting> -<![CDATA[ -;; Disable Output Buffering -output_buffering = Off - -;; Set HTTP header charset -default_charset = EUC-JP - -;; Set HTTP input encoding conversion to auto -mbstring.http_input = auto - -;; Convert HTTP output to EUC-JP -mbstring.http_output = EUC-JP - -;; Set internal encoding to EUC-JP -mbstring.internal_encoding = EUC-JP - -;; Do not print invalid characters -mbstring.substitute_character = none -]]> - </programlisting> - </example> - </para> - <para> - <example> - <title>&php.ini; setting for <literal>SJIS</literal> users</title> - <programlisting> -<![CDATA[ -;; Enable Output Buffering -output_buffering = On - -;; Set mb_output_handler to enable output conversion -output_handler = mb_output_handler - -;; Set HTTP header charset -default_charset = Shift_JIS - -;; Set http input encoding conversion to auto -mbstring.http_input = auto - -;; Convert to SJIS -mbstring.http_output = SJIS - -;; Set internal encoding to EUC-JP -mbstring.internal_encoding = EUC-JP - -;; Do not print invalid characters -mbstring.substitute_character = none -]]> - </programlisting> - </example> - </para> - </section> - <section id="mbstring.resources"> &reftitle.resources; &no.resource; Index: phpdoc/en/reference/mbstring/ini.xml +++ phpdoc/en/reference/mbstring/ini.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <section id="mbstring.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> <title>Multi-Byte String configuration options</title> <tgroup cols="3"> <thead> <row> <entry>Name</entry> <entry>Default</entry> <entry>Changeable</entry> </row> </thead> <tbody> <row> <entry>mbstring.language</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>mbstring.detect_order</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>mbstring.http_input</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>mbstring.http_output</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>mbstring.internal_encoding</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>mbstring.script_encoding</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>mbstring.substitute_character</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>mbstring.func_overload</entry> <entry>"0"</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>mbstring.encoding_translation</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> </tbody> </tgroup> </table> For further details and definition of the PHP_INI_* constants see <function>ini_set</function>. </para> <para> Here is a short explanation of the configuration directives. <itemizedlist> <listitem id="ini.mbstring.internal-encoding"> <simpara> <literal>mbstring.internal_encoding</literal> defines default internal character encoding. </simpara> </listitem> <listitem id="ini.mbstring.http-input"> <simpara> <literal>mbstring.http_input</literal> defines default HTTP input character encoding. </simpara> </listitem> <listitem id="ini.mbstring.http-output"> <simpara> <literal>mbstring.http_output</literal> defines default HTTP output character encoding. </simpara> </listitem> <listitem id="ini.mbstring.detect-order"> <simpara> <literal>mbstring.detect_order</literal> defines default character code detection order. See also <function>mb_detect_order</function>. </simpara> </listitem> <listitem id="ini.mbstring.substitute-character"> <simpara> <literal>mbstring.substitute_character</literal> defines character to substitute for invalid character encoding. </simpara> </listitem> </itemizedlist> </para> <para> Web Browsers are supposed to use the same character encoding when submitting form. However, browsers may not use the same character encoding. See <function>mb_http_input</function> to detect character encoding used by browsers. </para> <para> If <literal>enctype</literal> is set to <literal>multipart/form-data</literal> in HTML forms, <literal>mbstring</literal> does not convert character encoding in POST data. The user must convert them in the script, if conversion is needed. </para> <para> Although, browsers are smart enough to detect character encoding in HTML. <literal>charset</literal> is better to be set in HTTP header. Change <literal>default_charset</literal> according to character encoding. </para> <para> <example> <title>&php.ini; setting example</title> <programlisting> <![CDATA[ ;; 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 ;; Set default HTTP input character encoding ;; Note: Script cannot change http_input setting. mbstring.http_input = pass ; No conversion. mbstring.http_input = auto ; Set HTTP input to auto ; "auto" is expanded to "ASCII,JIS,UTF-8,EUC-JP,SJIS" mbstring.http_input = SJIS ; Set HTTP2 input to SJIS mbstring.http_input = UTF-8,SJIS,EUC-JP ; Specify order ;; Set default HTTP output character encoding mbstring.http_output = pass ; No conversion mbstring.http_output = UTF-8 ; Set HTTP output encoding to UTF-8 ;; Set default character encoding detection order mbstring.detect_order = auto ; Set detect order to auto mbstring.detect_order = ASCII,JIS,UTF-8,SJIS,EUC-JP ; Specify order ;; Set default substitute character mbstring.substitute_character = 12307 ; Specify Unicode value mbstring.substitute_character = none ; Do not print character mbstring.substitute_character = long ; Long Example: U+3000,JIS+7E7E ]]> </programlisting> </example> </para> <para> <example> <title>&php.ini; setting for <literal>EUC-JP</literal> users</title> <programlisting> <![CDATA[ ;; Disable Output Buffering output_buffering = Off ;; Set HTTP header charset default_charset = EUC-JP ;; Set HTTP input encoding conversion to auto mbstring.http_input = auto ;; Convert HTTP output to EUC-JP mbstring.http_output = EUC-JP ;; Set internal encoding to EUC-JP mbstring.internal_encoding = EUC-JP ;; Do not print invalid characters mbstring.substitute_character = none ]]> </programlisting> </example> </para> <para> <example> <title>&php.ini; setting for <literal>SJIS</literal> users</title> <programlisting> <![CDATA[ ;; Enable Output Buffering output_buffering = On ;; Set mb_output_handler to enable output conversion output_handler = mb_output_handler ;; Set HTTP header charset default_charset = Shift_JIS ;; Set http input encoding conversion to auto mbstring.http_input = auto ;; Convert to SJIS mbstring.http_output = SJIS ;; Set internal encoding to EUC-JP mbstring.internal_encoding = EUC-JP ;; Do not print invalid characters mbstring.substitute_character = none ]]> </programlisting> </example> </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 -->