iconv_substr函數怎麼用？一文帶你掌握它的基本用法和應用場景

gitbox 2025-08-04

iconv_substr函數是PHP 中用於截取字符串的一個強大工具，特別適用於多字節字符集（如UTF-8、GBK 等）。與傳統的substr函數不同， iconv_substr能夠正確處理包含多字節字符的字符串，在處理中文、日文、韓文等非拉丁字符集時表現尤為出色。

一、iconv_substr函數的基本語法

<span><span><span class="hljs-title function_ invoke__">iconv_substr</span></span><span>(</span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$str</span></span><span>, </span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$start</span></span><span>, </span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$length</span></span><span> = ?, </span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$encoding</span></span><span> = ?): </span><span><span class="hljs-keyword">string</span></span><span>|</span><span><span class="hljs-literal">false</span></span><span>
</span></span>

$str : 輸入的原始字符串，通常是你希望截取的字符串。
$start : 截取的起始位置，可以是負數，表示從字符串末尾開始計算。
$length : 截取的長度，指定你希望截取的字符數。如果不指定，默認截取到字符串的結尾。
$encoding : 字符集編碼，通常我們會使用UTF-8 或GBK。如果沒有指定，默認使用系統默認編碼。

二、使用示例

1. 基本示例

<span><span><span class="hljs-variable">$str</span></span><span> = </span><span><span class="hljs-string">"Hello, 你好，世界！"</span></span><span>;
</span><span><span class="hljs-variable">$result</span></span><span> = </span><span><span class="hljs-title function_ invoke__">iconv_substr</span></span><span>(</span><span><span class="hljs-variable">$str</span></span><span>, </span><span><span class="hljs-number">7</span></span><span>, </span><span><span class="hljs-number">3</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">$result</span></span><span>;  </span><span><span class="hljs-comment">// 輸出：你好</span></span><span>
</span></span>

在上面的例子中，我們從第7 個字符位置開始，截取長度為3 的字符。由於是UTF-8 編碼， iconv_substr能夠正確地處理中文字符。

2. 使用負數起始位置

<span><span><span class="hljs-variable">$str</span></span><span> = </span><span><span class="hljs-string">"Hello, 你好，世界！"</span></span><span>;
</span><span><span class="hljs-variable">$result</span></span><span> = </span><span><span class="hljs-title function_ invoke__">iconv_substr</span></span><span>(</span><span><span class="hljs-variable">$str</span></span><span>, -</span><span><span class="hljs-number">3</span></span><span>, </span><span><span class="hljs-number">3</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">$result</span></span><span>;  </span><span><span class="hljs-comment">// 輸出：世界</span></span><span>
</span></span>

在這個例子中， -3表示從字符串的倒數第三個字符開始截取，結果截取到"世界"。

3. 截取到字符串結尾

<span><span><span class="hljs-variable">$str</span></span><span> = </span><span><span class="hljs-string">"PHP 程式設計語言"</span></span><span>;
</span><span><span class="hljs-variable">$result</span></span><span> = </span><span><span class="hljs-title function_ invoke__">iconv_substr</span></span><span>(</span><span><span class="hljs-variable">$str</span></span><span>, </span><span><span class="hljs-number">4</span></span><span>, </span><span><span class="hljs-number">10</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">$result</span></span><span>;  </span><span><span class="hljs-comment">// 輸出：程式設計語言</span></span><span>
</span></span>

在此例中，我們指定從第4 個字符開始截取，但不指定截取的長度，默認會一直截取到字符串的末尾。

三、iconv_substr與substr的區別

substr是PHP 中的常用函數，適用於處理單字節字符集（如ASCII 字符），但它在處理多字節字符集時可能會出錯。例如，當你用substr截取中文字符串時，可能會導致字符亂碼或截取不完全。而iconv_substr則專門用於多字節字符集，能夠保證截取的準確性，避免亂碼。

示例：

 <span><span><span class="hljs-variable">$str</span></span><span> = </span><span><span class="hljs-string">"PHP中文教程"</span></span><span>;
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">substr</span></span><span>(</span><span><span class="hljs-variable">$str</span></span><span>, </span><span><span class="hljs-number">3</span></span><span>, </span><span><span class="hljs-number">2</span></span><span>);  </span><span><span class="hljs-comment">// 可能会輸出乱码</span></span><span>
</span></span>

 <span><span><span class="hljs-variable">$str</span></span><span> = </span><span><span class="hljs-string">"PHP中文教程"</span></span><span>;
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">iconv_substr</span></span><span>(</span><span><span class="hljs-variable">$str</span></span><span>, </span><span><span class="hljs-number">3</span></span><span>, </span><span><span class="hljs-number">2</span></span><span>, </span><span><span class="hljs-string">"UTF-8"</span></span><span>);  </span><span><span class="hljs-comment">// 正确輸出：中文</span></span><span>
</span></span>

四、應用場景

iconv_substr函數在許多實際應用場景中都非常有用，尤其是在處理多字節字符集時。以下是一些常見的應用場景：

1. 截取中文字符串

在開發多語言支持的網頁或應用時，通常需要從中文文本中截取一定長度的字符串， iconv_substr就能確保准確地截取到完整的字符，而不會造成亂碼或錯誤。

2. 截取文件名或路徑

當處理包含中文、日文等非拉丁字符集的文件名時，使用iconv_substr可以確保文件名或路徑被正確截取，避免亂碼問題。

3. 數據庫中截取字段

在與數據庫交互時， iconv_substr可以用來截取數據庫中的文本字段，特別是在存儲多語言文本（如中文、日文等）時，確保截取的文本沒有出現亂碼或不完整字符。

4. 字符串分頁顯示

在一些應用中，我們可能需要將長文本分頁顯示， iconv_substr可以幫助我們精確截取每一頁需要顯示的文本，避免出現半個字符的情況。

五、總結

iconv_substr是一個非常實用的PHP 函數，特別適合處理多字節字符集的字符串操作。在處理中文、日文、韓文等多字節字符集時， iconv_substr能夠提供更好的支持，確保截取的準確性。掌握這個函數的基本用法和應用場景，對於開發國際化的PHP 應用程序非常重要。