函數重載功能

警告

本特性自 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)定,也許會導致不確定的行為。