函数重载功能

Warning

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

你也许常常会发现现存的 PHP 应用很难运行在多字节环境下。 发生这种情况的原因是大多数那种 PHP 应用使用了标准的字符串函数,类似 substr,已知无法处理多字节编码的字符串。

mbstring 支持一个“函数重载”功能,将对应的多字节版本重载到标准字符处理函数上,例如你能够让这类应用在不修改代码的前提下添加多字节的处理能力。 比如,启用函数重载后,mb_substr 将会代替 substr 被调用。 在很多情况下这个功能允许让仅支持单字节编码的应用简单地和多字节环境对接。

要使用函数重载功能,设置 php.ini 里的 mbstring.func_overload 为正值,就是表示为重载函数分类的位掩码组合。 要重载 mail 函数需要设置它为 1。字符串函数设置为 2,正则表达式函数为 4。 例如,当它设置为 7, mail、strings 和 正则表达式函数将都会被重载。 以下列表显示了重载的函数。

mbstring.func_overload 的值原始函数重载后的函数
1mailmb_send_mail
2strlenmb_strlen
2strposmb_strpos
2strrposmb_strrpos
2substrmb_substr
2strtolowermb_strtolower
2strtouppermb_strtoupper
2striposmb_stripos
2strriposmb_strripos
2strstrmb_strstr
2stristrmb_stristr
2strrchrmb_strrchr
2substr_countmb_substr_count
4eregmb_ereg
4eregimb_eregi
4ereg_replacemb_ereg_replace
4eregi_replacemb_eregi_replace
4splitmb_split

Note:

不推荐每个目录的范围(context)内使用函数重载选项,因为还无法确定在生产环境中是否稳定,也许会导致不确定的行为。