©
This document uses PHP Chinese website manual Release
这些函数的行为受 php.ini 中的设置影响。
名字 | 默认 | 可修改范围 | 更新日志 |
---|---|---|---|
mbstring.language | "neutral" | PHP_INI_ALL | 自 PHP 4.3.0 起有效。 PHP_INI_PERDIR 位于 PHP <= 5.2.6 |
mbstring.detect_order | NULL | PHP_INI_ALL | 自 PHP 4.0.6 起有效。 |
mbstring.http_input | "pass" | PHP_INI_ALL | 自 PHP 4.0.6 起有效。 |
mbstring.http_output | "pass" | PHP_INI_ALL | 自 PHP 4.0.6 起有效。 |
mbstring.internal_encoding | NULL | PHP_INI_ALL | 自 PHP 4.0.6 起有效。 |
mbstring.script_encoding | NULL | PHP_INI_ALL | 自 PHP 4.3.0 起有效。 在 PHP 5.4.0. 中移除, 使用 zend.script_encoding 代替。 |
mbstring.substitute_character | NULL | PHP_INI_ALL | 自 PHP 4.0.6 起有效。 |
mbstring.func_overload | "0" | PHP_INI_SYSTEM | PHP 4.3 到 5.2.6 是 PHP_INI_PERDIR,否则是 PHP_INI_SYSTEM。 自 PHP 4.2.0 起有效。 |
mbstring.encoding_translation | "0" | PHP_INI_PERDIR | 自 PHP 4.3.0 起有效。 |
mbstring.strict_detection | "0" | PHP_INI_ALL | 自 PHP 5.1.2 起有效。 |
这是配置指令的简短说明。
mbstring.language
string mbstring 使用了国家默认语言设置(NLS)。 注意,该选项自动地定义了 mbstring.internal_encoding 和 mbstring.internal_encoding,在 php.ini 里应当放置在 mbstring.language 之后。
mbstring.encoding_translation
boolean 为传入的 HTTP 查询启用透明字符编码过滤器,将检测和转换输入的编码为内部字符编码(internal character encoding)。
mbstring.internal_encoding
string This feature has been DEPRECATED as of PHP 5.6.0. Relying on this feature is highly discouraged.
定义内部字符的默认编码。
PHP 5.6 及更新版的用户应该将此选项留空,并设置
default_charset
作为代替。
mbstring.http_input
string This feature has been DEPRECATED as of PHP 5.6.0. Relying on this feature is highly discouraged.
定义 HTTP 输入字符的默认编码。
PHP 5.6 及更新版的用户应该将此选项留空,并设置
default_charset
作为代替。
mbstring.http_output
string This feature has been DEPRECATED as of PHP 5.6.0. Relying on this feature is highly discouraged.
定义 HTTP 输出字符的默认编码。
PHP 5.6 及更新版的用户应该将此选项留空,并设置
default_charset
作为代替。
mbstring.detect_order
string 定义字符编码的默认检测顺序。参见 mb_detect_order() 。
mbstring.substitute_character
string 为无效编码的字符定义替代字符。
mbstring.func_overload
string 用 mbstring 对应的函数覆盖单字节版本的函数集。更多信息参见函数的覆盖。
该设置仅能通过 php.ini 文件来修改。
mbstring.strict_detection
boolean 使用严格的编码检测。
根据 » HTML4.01 规范,允许 Web 浏览器以页面不同的字符编码来提交表单。 参见用 mb_http_input() 来检测浏览器使用的字符编码。
尽管流行的浏览器能够根据给出的 HTML 文档合理猜测正确的编码,但如果能通过 header() 函数在 HTTP 的 Content-Type 头内或 ini 的 default_charset 里设置适当的 charset 参数则会更佳。
Example #1 php.ini 设置例子
; 设置默认语言 mbstring.language = Neutral; 设置默认语言 Neutral(UTF-8) (默认的值) mbstring.language = English; 设置默认语言为 English mbstring.language = Japanese; 设置默认语言为 Japanese;; 设置内部的默认编码 ;; 注意:请确保这个编码能被 PHP 所处理 mbstring.internal_encoding = UTF-8 ; 设置内部的默认编码为 UTF-8;; 启用 HTTP 输入编码的转换 mbstring.encoding_translation = On;; 设置 HTTP 输入的默认编码 ;; 注意:脚本不能修改 http_input 的设置 mbstring.http_input = pass ; 不转换 mbstring.http_input = auto ; 设置 HTTP 输入为 auto ; "auto" 会根据 mbstring.language 自动扩展 mbstring.http_input = SJIS ; 设置 HTTP 输入编码为 SJIS mbstring.http_input = UTF-8,SJIS,EUC-JP ; 指定顺序;; 设置 HTTP 输出的默认编码 mbstring.http_output = pass ; 不转换 mbstring.http_output = UTF-8 ; 设置 HTTP 输出编码为 UTF-8;; 设置字符编码的默认检测顺序 mbstring.detect_order = auto ; Set detect order to auto mbstring.detect_order = ASCII,JIS,UTF-8,SJIS,EUC-JP ; Specify order;; 设置默认的替代字符 mbstring.substitute_character = 12307 ; 指定 Unicode 值 mbstring.substitute_character = none ; 不打印字符 mbstring.substitute_character = long ; Long 的例子: U+3000,JIS+7E7E
Example #2 php.ini 里 EUC-JP 用户的设置
;; 禁用输出缓冲 output_buffering = Off;; 设置 HTTP header 字符编码 default_charset = EUC-JP ;; 设置默认语言为 Japanese mbstring.language = Japanese;; 启用 HTTP 输入编码的转换 mbstring.encoding_translation = On;; 启用 HTTP 输入转换的编码为 auto mbstring.http_input = auto ;; 转换 HTTP 输出的编码为 EUC-JP mbstring.http_output = EUC-JP ;; 设置内部编码为 EUC-JP mbstring.internal_encoding = EUC-JP ;; 不要打印无效的字符 mbstring.substitute_character = none
Example #3 php.ini 里 SJIS 用户的设置
;; 启用输出缓冲 output_buffering = On;; 设置 mb_output_handler 来启用输出编码的转换 output_handler = mb_output_handler;; 设置 HTTP header 的字符编码 default_charset = Shift_JIS;; 设置默认语言为 Japanese mbstring.language = Japanese;; 设置 http 输入转换的编码为 auto mbstring.http_input = auto ;; 转换成 SJIS mbstring.http_output = SJIS ;; 设置内部变量为 EUC-JP mbstring.internal_encoding = EUC-JP ;; 不要打印无效的字符 mbstring.substitute_character = none
[#1] PRETTYGIRL NOT COMe [2013-08-17 23:51:52]
Note that you should better at least set "mbstring.internal_encoding".
Just check as below:
<?php
echo mb_internal_encoding() . '<br />';
echo mb_regex_encoding();
?>
You might be surprised at unexpected values.
eg.
mbstring.language Japanese
;mbstring.internal_encoding (commented out showing "no value" in phpinfo() )
These two lines in "php.ini" are the same values as
mb_internal_encoding("EUC-JP");
mb_regex_encoding("EUC-JP");
in Win / Linux servers.
"mbstring.internal_encoding" defines the default encoding for "mb_" Functions such as "mb_strlen()".
It also defines the same for "mb_ereg_" Functions such as "mb_ereg()" when you don't set "mb_regex_encoding".