本特性自 PHP 7.2.0 起廢棄,并且自 PHP 8.0.0 起被移除。 強烈建議不要使用本特性。
你也許常常會發(fā)現現存的 PHP 應用很難運行在多字節(jié)環(huán)境下。 發(fā)生這種情況的原因是大多數那種 PHP 應用使用了標準的字符串函數,類似 substr(),已知無法處理多字節(jié)編碼的字符串。
mbstring 支持一個“函數重載”功能,將對應的多字節(jié)版本重載到標準字符處理函數上,例如你能夠讓這類應用在不修改代碼的前提下添加多字節(jié)的處理能力。 比如,啟用函數重載后,mb_substr() 將會代替 substr() 被調用。 在很多情況下這個功能允許讓僅支持單字節(jié)編碼的應用簡單地和多字節(jié)環(huán)境對接。
要使用函數重載功能,設置 php.ini 里的 mbstring.func_overload
為正值,就是表示為重載函數分類的位掩碼組合。
要重載 mail() 函數需要設置它為 1。字符串函數設置為 2,正則表達式函數為 4。
例如,當它設置為 7, mail、strings 和 正則表達式函數將都會被重載。
以下列表顯示了重載的函數。
mbstring.func_overload 的值 | 原始函數 | 重載后的函數 |
---|---|---|
1 | mail() | mb_send_mail() |
2 | strlen() | mb_strlen() |
2 | strpos() | mb_strpos() |
2 | strrpos() | mb_strrpos() |
2 | substr() | mb_substr() |
2 | strtolower() | mb_strtolower() |
2 | strtoupper() | mb_strtoupper() |
2 | stripos() | mb_stripos() |
2 | strripos() | mb_strripos() |
2 | strstr() | mb_strstr() |
2 | stristr() | mb_stristr() |
2 | strrchr() | mb_strrchr() |
2 | substr_count() | mb_substr_count() |
注意:
不推薦每個目錄的范圍(context)內使用函數重載選項,因為還無法確定在生產環(huán)境中是否穩(wěn)定,也許會導致不確定的行為。