mb_substitute_character和mb_convert_encoding一起用時有什麼技巧？

gitbox 2025-09-28

1. mb_substitute_character的作用

mb_substitute_character是多字節字符集函數庫中的一個設置項，用來定義在字符編碼轉換失敗時的替代字符。當某個字符無法被正確轉換時， mb_substitute_character決定了PHP如何處理這個無法轉換的字符。默認情況下，如果字符無法轉換，PHP會使用?作為替代字符。

例如，如果從UTF-8轉換到GBK時遇到GBK中無法表示的字符，默認行為會是將這些字符替換為問號? 。

 <span><span><span class="hljs-title function_ invoke__">mb_substitute_character</span></span><span>(</span><span><span class="hljs-string">'none'</span></span><span>); </span><span><span class="hljs-comment">// 不使用替代字符</span></span><span>
</span><span><span class="hljs-title function_ invoke__">mb_substitute_character</span></span><span>(</span><span><span class="hljs-string">'?'</span></span><span>);    </span><span><span class="hljs-comment">// 使用"?"作為替代字符</span></span><span>
</span></span>

通過調用mb_substitute_character ，你可以控制替代字符的形式，甚至將其設置為空字符串或某個特定的符號。

2. mb_convert_encoding的作用

mb_convert_encoding是PHP中用於轉換字符編碼的函數，它支持多種字符編碼格式，常用的如UTF-8 、 GBK 、 ISO-8859-1等。

 <span><span><span class="hljs-variable">$str</span></span><span> = </span><span><span class="hljs-string">"中文字符串"</span></span><span>;
</span><span><span class="hljs-variable">$converted_str</span></span><span> = </span><span><span class="hljs-title function_ invoke__">mb_convert_encoding</span></span><span>(</span><span><span class="hljs-variable">$str</span></span><span>, </span><span><span class="hljs-string">'ISO-8859-1'</span></span><span>, </span><span><span class="hljs-string">'UTF-8'</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$converted_str</span></span><span>;
</span></span>

它將$str從UTF-8編碼轉換成ISO-8859-1編碼，轉換時會根據源字符串中的字符決定是否需要進行替換。如果目標編碼無法表示源字符中的某些字符， mb_substitute_character的配置將決定替代字符的表現形式。

3. 二者的協同使用技巧

當你需要將一個字符串從一種編碼轉換到另一種編碼，並且你希望處理過程中遇到的任何無法轉換的字符時， mb_substitute_character和mb_convert_encoding的協同使用是至關重要的。以下是一些常見的技巧：

3.1 設置適當的替代字符

在某些情況下，源字符串中的字符無法在目標編碼中找到對應的字符。這時，你可以通過mb_substitute_character設置替代字符的方式來避免亂碼問題。比如，將無法轉換的字符替換成特定的符號或字符串。

 <span><span><span class="hljs-title function_ invoke__">mb_substitute_character</span></span><span>(</span><span><span class="hljs-string">'!'</span></span><span>);
</span><span><span class="hljs-variable">$str</span></span><span> = </span><span><span class="hljs-title function_ invoke__">mb_convert_encoding</span></span><span>(</span><span><span class="hljs-string">'你好，世界'</span></span><span>, </span><span><span class="hljs-string">'ASCII'</span></span><span>, </span><span><span class="hljs-string">'UTF-8'</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$str</span></span><span>; </span><span><span class="hljs-comment">// 輸出 "???,!"</span></span><span>
</span></span>

在這個例子中，字符你好，世界中的中文部分無法在ASCII編碼中表示，因此替代字符!被用來代替無法轉換的字符。

3.2 避免不必要的替換

如果你希望完全避免字符的替換，而是直接返回原始字符串或發生錯誤時停止執行，可以將mb_substitute_character設置為none 。這時，所有無法轉換的字符將不會被替換，系統可能會拋出錯誤或返回不可預知的結果。

 <span><span><span class="hljs-title function_ invoke__">mb_substitute_character</span></span><span>(</span><span><span class="hljs-string">'none'</span></span><span>);
</span><span><span class="hljs-variable">$str</span></span><span> = </span><span><span class="hljs-title function_ invoke__">mb_convert_encoding</span></span><span>(</span><span><span class="hljs-string">'你好，世界'</span></span><span>, </span><span><span class="hljs-string">'ASCII'</span></span><span>, </span><span><span class="hljs-string">'UTF-8'</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$str</span></span><span>; </span><span><span class="hljs-comment">// 如果無法轉換，會出現警告或錯誤</span></span><span>
</span></span>

3.3 使用合適的目標編碼

確保目標編碼能夠有效支持源編碼中的所有字符。如果你知道源字符串主要使用某種字符集，而目標字符集支持更廣泛的字符（如UTF-8），那麼可以避免使用替代字符。一般來說，UTF-8是一個通用的編碼選擇，幾乎可以兼容所有語言的字符。

 <span><span><span class="hljs-variable">$str</span></span><span> = </span><span><span class="hljs-string">"中文字符串"</span></span><span>;
</span><span><span class="hljs-variable">$converted_str</span></span><span> = </span><span><span class="hljs-title function_ invoke__">mb_convert_encoding</span></span><span>(</span><span><span class="hljs-variable">$str</span></span><span>, </span><span><span class="hljs-string">'UTF-8'</span></span><span>, </span><span><span class="hljs-string">'GBK'</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$converted_str</span></span><span>; </span><span><span class="hljs-comment">// 正常轉換</span></span><span>
</span></span>

如果你不確定目標編碼是否能支持所有字符，最好提前驗證字符轉換的結果，或者採用mb_substitute_character來處理那些可能轉換失敗的字符。

3.4 適時使用mb_convert_encoding的錯誤處理

在一些情況下，使用mb_convert_encoding時如果遇到無法轉換的字符，可能需要使用錯誤處理機制來確保轉換過程順利。你可以使用@來抑制警告，並根據業務需求來決定是否需要額外的錯誤捕獲。

 <span><span><span class="hljs-title function_ invoke__">mb_substitute_character</span></span><span>(</span><span><span class="hljs-string">'none'</span></span><span>);
</span><span><span class="hljs-variable">$str</span></span><span> = @</span><span><span class="hljs-title function_ invoke__">mb_convert_encoding</span></span><span>(</span><span><span class="hljs-string">'無法轉換的字符'</span></span><span>, </span><span><span class="hljs-string">'UTF-8'</span></span><span>, </span><span><span class="hljs-string">'ISO-8859-1'</span></span><span>);
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$str</span></span><span> === </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"字符轉換失敗"</span></span><span>;
}
</span></span>

4. 總結

mb_substitute_character和mb_convert_encoding是兩個功能強大的PHP函數，可以幫助我們在字符編碼轉換中處理各種複雜情況。合理使用這兩個函數，可以有效避免亂碼問題並提供更好的用戶體驗。

設置合適的替代字符（如mb_substitute_character ）可以讓你在字符轉換失敗時避免產生不必要的亂碼。
使用mb_convert_encoding時，合理選擇目標編碼，並確保源字符串與目標編碼兼容，能夠減少字符丟失的可能性。

通過靈活運用這兩個函數，PHP開發者可以在字符編碼處理方面更加得心應手，提升應用的跨平台和國際化支持能力。