如何用iconv_substr結合strlen來控製字符串長度？實用技巧分享

gitbox 2025-09-08

在PHP編程中，處理字符串長度時，特別是對於多字節字符集（如中文、日文、韓文等）時，常常會遇到一些挑戰。由於strlen()和substr()函數默認是針對單字節字符設計的，它們在多字節字符中可能會出現問題。幸運的是，PHP提供了一個功能強大的函數庫iconv ，其中iconv_substr()可以很好地解決這個問題。今天，我們就來探討如何用iconv_substr()和strlen()結合使用，精確控製字符串長度。

為什麼要使用iconv_substr？

在傳統的substr()和strlen()函數中，如果我們處理的是多字節字符（比如中文）， strlen()會計算字符的字節數，而不是字符的個數。這可能導致計算出的字符串長度不符合預期。例如：

 <span><span><span class="hljs-variable">$string</span></span><span> = </span><span><span class="hljs-string">"你好，世界！"</span></span><span>;
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">strlen</span></span><span>(</span><span><span class="hljs-variable">$string</span></span><span>); </span><span><span class="hljs-comment">// 輸出 18</span></span><span>
</span></span>

此時， strlen()返回的是字節數而不是字符數。中文字符每個佔用3個字節，所以這個字符串有6個字符，但strlen()誤返回了18個字節。

而iconv_substr()是專門用於處理多字節字符的，它能夠正確地計算字符數，而不是字節數，因此它能精確地控製字符串的長度。

如何結合使用iconv_substr和strlen？

1. 計算字符串的字符數

首先，我們需要用iconv_strlen()來計算字符串的字符數，而不是字節數。 iconv_strlen()會返回字符串中的實際字符數，無論字符集是單字節還是多字節。

 <span><span><span class="hljs-variable">$string</span></span><span> = </span><span><span class="hljs-string">"你好，世界！"</span></span><span>;
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">iconv_strlen</span></span><span>(</span><span><span class="hljs-variable">$string</span></span><span>, </span><span><span class="hljs-string">'UTF-8'</span></span><span>); </span><span><span class="hljs-comment">// 輸出 6</span></span><span>
</span></span>

2. 使用iconv_substr進行截取

接下來，我們可以使用iconv_substr()來截取字符串，它的參數和substr()類似，但支持多字節字符集的正確截取。通過結合iconv_strlen()和iconv_substr() ，我們可以精確地控制截取字符串的字符長度。

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

在這個例子中， iconv_substr()從字符串的第一個字符開始截取，截取了3個字符。這裡， length是字符數而非字節數，這就避免了substr()中可能出現的字節數不准確的問題。

3. 動態控製字符串長度

有時我們需要根據不同的條件動態地控製字符串的長度，比如限制顯示的字數。通過iconv_substr()和iconv_strlen()的組合，我們可以很方便地實現這一點。

 <span><span><span class="hljs-function"><span class="hljs-keyword">function</span></span></span><span> </span><span><span class="hljs-title">truncate_string</span></span><span>(</span><span><span class="hljs-params"><span class="hljs-variable">$string</span></span></span><span>, </span><span><span class="hljs-variable">$max_length</span></span><span>) {
    </span><span><span class="hljs-variable">$length</span></span><span> = </span><span><span class="hljs-title function_ invoke__">iconv_strlen</span></span><span>(</span><span><span class="hljs-variable">$string</span></span><span>, </span><span><span class="hljs-string">'UTF-8'</span></span><span>);
    </span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$length</span></span><span> &gt; </span><span><span class="hljs-variable">$max_length</span></span><span>) {
        </span><span><span class="hljs-keyword">return</span></span><span> </span><span><span class="hljs-title function_ invoke__">iconv_substr</span></span><span>(</span><span><span class="hljs-variable">$string</span></span><span>, </span><span><span class="hljs-number">0</span></span><span>, </span><span><span class="hljs-variable">$max_length</span></span><span>, </span><span><span class="hljs-string">'UTF-8'</span></span><span>) . </span><span><span class="hljs-string">'...'</span></span><span>;
    } </span><span><span class="hljs-keyword">else</span></span><span> {
        </span><span><span class="hljs-keyword">return</span></span><span> </span><span><span class="hljs-variable">$string</span></span><span>;
    }
}

</span><span><span class="hljs-variable">$string</span></span><span> = </span><span><span class="hljs-string">"你好，世界！這是一個測試字符串。"</span></span><span>;
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">truncate_string</span></span><span>(</span><span><span class="hljs-variable">$string</span></span><span>, </span><span><span class="hljs-number">10</span></span><span>); </span><span><span class="hljs-comment">// 輸出 "你好，世界！..."</span></span><span>
</span></span>

在這個例子中， truncate_string()函數根據給定的最大長度截取字符串，並在末尾添加省略號。

總結

通過使用iconv_substr()和iconv_strlen() ，我們能夠有效地解決多字節字符集中的字符串長度控制問題。這些函數讓我們能夠精確地按字符而不是字節來操作字符串，避免了strlen()和substr()在多字節字符上的不准確性。如果你的項目需要處理多語言，特別是包含中文、日文、韓文等字符集時，這兩個函數是非常實用的工具。