iconv_strrpos 函數的基本用法詳解，如何在PHP 中正確使用iconv_strrpos 查找字符串位置？

gitbox 2025-08-14

在PHP 開發中，處理多字節字符串（例如包含中文、日文、韓文等字符的字符串）時，常規的字符串函數如strrpos()往往無法正確地處理字符邊界問題，可能會導致截取錯誤或查找失敗。為了更好地支持多字節字符集，PHP 提供了iconv_strrpos()函數。本文將詳細介紹該函數的基本用法、參數意義以及使用注意事項，幫助你在編碼中正確查找字符串中最後一次出現的位置。

一、函數簡介

iconv_strrpos()是iconv 擴展中的一個函數，用於查找一個字符串中，某個子字符串最後一次出現的位置。與strrpos()不同的是，它在處理多字節編碼時能夠更準確地識別字符邊界。

函數原型：

 <span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-title function_ invoke__">iconv_strrpos</span></span><span> ( </span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$haystack</span></span><span> , </span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$needle</span></span><span> [, </span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$charset</span></span><span> = </span><span><span class="hljs-title function_ invoke__">ini_get</span></span><span>(</span><span><span class="hljs-string">"iconv.internal_encoding"</span></span><span>)] )
</span></span>

參數說明：

$haystack ：要搜索的目標字符串。
$needle ：要查找的子字符串。
$charset （可選）：指定字符串的字符集編碼。如果未設置，默認使用iconv.internal_encoding的設置。

返回值：

返回$needle在$haystack中最後一次出現的位置（從0 開始的偏移量），如果找不到則返回false 。

二、基本使用示例

示例一：處理英文字符串

<span><span><span class="hljs-variable">$str</span></span><span> = </span><span><span class="hljs-string">"hello world, welcome to the world of PHP"</span></span><span>;
</span><span><span class="hljs-variable">$pos</span></span><span> = </span><span><span class="hljs-title function_ invoke__">iconv_strrpos</span></span><span>(</span><span><span class="hljs-variable">$str</span></span><span>, </span><span><span class="hljs-string">"world"</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$pos</span></span><span>; </span><span><span class="hljs-comment">// 輸出 27</span></span><span>
</span></span>

這個例子中，字符串"world" 最後一次出現的位置是索引27。

示例二：處理中文字符串（使用UTF-8 編碼）

 <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">$needle</span></span><span> = </span><span><span class="hljs-string">"你好"</span></span><span>;
</span><span><span class="hljs-variable">$pos</span></span><span> = </span><span><span class="hljs-title function_ invoke__">iconv_strrpos</span></span><span>(</span><span><span class="hljs-variable">$str</span></span><span>, </span><span><span class="hljs-variable">$needle</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">$pos</span></span><span>; </span><span><span class="hljs-comment">// 輸出 6（表示第二個“你好”在多字節下的字符偏移位置）</span></span><span>
</span></span>

注意：如果使用strrpos()來處理這個字符串，可能會因為字符集問題導致錯誤的結果或亂碼，因此在處理中文時一定要顯式指定編碼。

三、與strrpos 的區別

函數	是否支持多字節	推薦場景
strrpos()	否	單字節字符串（如ASCII）
iconv_strrpos()	是	多字節字符串（如UTF-8、GBK）

如果你正在處理UTF-8 編碼的內容（例如網站的多語言頁面），強烈建議使用iconv_strrpos()以避免由於字符邊界處理不當導致的問題。

四、使用建議與註意事項

指定字符集很重要：如果你沒有顯式指定$charset ，PHP 會使用默認的iconv.internal_encoding ，這可能與你實際使用的字符串編碼不一致，從而導致錯誤。
確保iconv 擴展已啟用：該函數屬於iconv 擴展，默認通常會隨PHP 安裝啟用，但在某些自定義環境中可能需要手動開啟。
位置返回的是字符偏移，而不是字節偏移：在多字節編碼中，這一點非常關鍵，否則容易在後續字符串截取或處理時發生混亂。

五、總結

iconv_strrpos()是處理多字節字符串時非常實用的一個函數，它能夠正確地識別字符邊界，幫助開發者準確查找子字符串的位置。尤其在處理中文或其他非ASCII 字符時，正確使用該函數可以大大提高程序的穩定性和國際化兼容性。

建議每當你面對UTF-8 編碼的內容時，優先使用iconv_strrpos()而非strrpos() ，並始終記得顯式指定字符集以避免不必要的問題。