安装/配置

目录

需求

构建此扩展不需要其他扩展。

安装

mbstring 不是一个默认扩展。这意味着它默认没有被激活。 你必须在 configure 选项中显式激活该模块。 详情参见安装这一节。

以下是涉及到 mbstring 的相关配置选项。

  • --enable-mbstring:激活 mbstring 函数。 要使用 mbstring 函数必须启用这个选项。

    libmbflmbstring 是必要的。 libmbfl 被捆绑到了 mbstring。 如果系统已安装 libmbfl--with-libmbfl[=DIR] 可以指定使用已安装的库。

  • --disable-mbregex:禁用正则表达式函数中多字节字符的支持。

运行时配置

这些函数的行为受 php.ini 中的设置影响。

名字默认可修改范围更新日志
mbstring.language"neutral"PHP_INI_ALL自 PHP 4.3.0 起有效。 PHP_INI_PERDIR 位于 PHP <= 5.2.6
mbstring.detect_orderNULLPHP_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_encodingNULLPHP_INI_ALL自 PHP 4.0.6 起有效。
mbstring.script_encodingNULLPHP_INI_ALL自 PHP 4.3.0 起有效。 在 PHP 5.4.0. 中移除, 使用 zend.script_encoding 代替。
mbstring.substitute_characterNULLPHP_INI_ALL自 PHP 4.0.6 起有效。
mbstring.func_overload"0"PHP_INI_SYSTEMPHP 4.3 到 5.2.6 是 PHP_INI_PERDIR,否则是 PHP_INI_SYSTEM。 自 PHP 4.2.0 起有效。 PHP 7.2.0 中废弃。
mbstring.encoding_translation"0"PHP_INI_PERDIR自 PHP 4.3.0 起有效。
mbstring.http_output_conv_mimetypes"^(text/|application/xhtml\+xml)"PHP_INI_ALLAvailable since PHP 5.3.0.
mbstring.strict_detection"0"PHP_INI_ALL自 PHP 5.1.2 起有效。

有关 PHP_INI_* 样式的更多详情与定义,见 配置可被设定范围

这是配置指令的简短说明。

mbstring.language string
mbstring 使用了国家默认语言设置(NLS)。 注意,该选项自动地定义了 mbstring.internal_encodingmbstring.internal_encoding,在 php.ini 里应当放置在 mbstring.language 之后。

mbstring.encoding_translation boolean
为传入的 HTTP 查询启用透明字符编码过滤器,将检测和转换输入的编码为内部字符编码(internal character encoding)。

mbstring.internal_encoding string
Warning 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
Warning 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
Warning 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
为无效编码的字符定义替代字符。 参见 mb_substitute_character ,查看支持的值。

mbstring.func_overload string
Warning This feature has been DEPRECATED as of PHP 7.2.0. Relying on this feature is highly discouraged.

用 mbstring 对应的函数覆盖单字节版本的函数集。更多信息参见函数的覆盖

该设置仅能通过 php.ini 文件来修改。

mbstring.http_output_conv_mimetypes string

mbstring.strict_detection boolean
使用严格的编码检测。

根据 » HTML4.01 规范,允许 Web 浏览器以页面不同的字符编码来提交表单。 参见用 mb_http_input 来检测浏览器使用的字符编码。

尽管流行的浏览器能够根据给出的 HTML 文档合理猜测正确的编码,但如果能通过 header 函数在 HTTP 的 Content-Type 头内或 ini 的 default_charset 里设置适当的 charset 参数则会更佳。

示例 #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

示例 #2 php.iniEUC-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   

示例 #3 php.iniSJIS 用户的设置

;; 启用输出缓冲
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   

资源类型

此扩展没有定义资源类型。