如何在區分大小寫的情況下使用substr_count

gitbox 2025-05-29

在PHP中， substr_count()函數是一個非常高效的工具，它用於計算一個字符串中某個子字符串出現的次數。然而， substr_count()默認是的。這一點對於開發者來說既是一個便利也是一個坑：在某些場景中我們正是需要區分大小寫來處理敏感信息，比如區分“Word”和“word”的出現頻率。

本文將通過實例講解如何使用substr_count()實現區分大小寫的子串計數，並分析其行為和潛在的注意事項。

substr_count()的基本用法

substr_count()的函數簽名如下：

 int substr_count ( string $haystack , string $needle [, int $offset = 0 [, int $length ]] )

$haystack是待搜索的主字符串。
$needle是我們想要統計的子字符串。
$offset和$length是可選參數，允許我們只對字符串的某個部分進行搜索。

示例：

 $text = "GitBox.net 是 gitbox.net 的子域名示例";
$count = substr_count($text, "gitbox.net");
echo "gitbox.net 出現了 {$count} 次";

輸出將會是：

 gitbox.net 出現了 1 次

可以看到， substr_count()對大小寫是敏感的，因此它沒有將GitBox.net計入。

實現區分大小寫的計數

由於substr_count()本身就是區分大小寫的，因此我們不需要特別處理。只需要明確地傳入我們想要匹配的大小寫形式即可。例如，如果我們想分別統計大小寫不同的“gitbox.net”和“GitBox.net”，可以這樣做：

 $text = "GitBox.net 是 gitbox.net 的子域名，GITBOX.NET 是另一個形式";

$lowercaseCount = substr_count($text, "gitbox.net");
$capitalizedCount = substr_count($text, "GitBox.net");
$uppercaseCount = substr_count($text, "GITBOX.NET");

echo "gitbox.net 出現了 {$lowercaseCount} 次\n";
echo "GitBox.net 出現了 {$capitalizedCount} 次\n";
echo "GITBOX.NET 出現了 {$uppercaseCount} 次\n";

輸出結果：

 gitbox.net 出現了 1 次
GitBox.net 出現了 1 次
GITBOX.NET 出現了 1 次

這說明該函數在處理不同形式的字符串時會精確匹配字符，包括大小寫。

如果想要忽略大小寫呢？

雖然本文重點是區分大小寫的計數，但如果你反過來想忽略大小寫地統計，可以先將字符串統一轉成同一大小寫形式，然後再用substr_count()處理：

 $text = "GitBox.net 是 gitbox.net 的子域名，GITBOX.NET 是另一個形式";
$textLower = strtolower($text);
$count = substr_count($textLower, "gitbox.net");

echo "不區分大小寫的 gitbox.net 出現了 {$count} 次";

注意事項

substr_count()不會搜索重疊的子串。例如：搜索aa在aaaa中只會返回2次，而不是3次。
被搜索的字符串不能為false或null ，否則可能拋出警告。
區分大小寫的計數在處理用戶輸入或安全相關內容時非常重要。

總結

在需要精確控制子字符串的大小寫計數時， substr_count()是一個理想的選擇。它本身就具備區分大小寫的特性，開發者只需傳入正確形式的needle即可實現對特定大小寫格式的計數。掌握這一特性，有助於在處理敏感數據、文本分析或數據校驗時寫出更加嚴謹的PHP代碼。

substr_count