如何在区分大小写的情况下使用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