PHP判断字符串是否包含指定内容的方法

在PHP开发中，判断字符串是否包含特定子字符串是一项常见任务。本文深入探讨了PHP中实现此功能的多种方法，重点介绍了`strpos()`函数，它通过返回子字符串首次出现的索引来判断包含关系，并强调使用`!== false`进行严格比较的重要性。针对大小写敏感性，文章推荐使用`stripos()`函数进行不区分大小写的判断，避免手动转换大小写带来的性能损耗。同时，针对多字节字符（如中文）的处理，推荐使用`mb_strpos()`和`mb_stripos()`函数，并明确指定编码，以防止乱码。此外，文章还介绍了PHP 8引入的`str_contains()`函数，它以更简洁的方式直接返回`true`或`false`，简化了代码。最后，文章还提及了`preg_match()`、`strstr()`和`stristr()`等函数在特定场景下的应用，并提供了最佳实践建议，帮助开发者根据PHP版本、字符编码、大小写敏感性和匹配复杂度选择最合适的字符串包含判断方法。

PHP中判断字符串包含关系的核心方法是使用strpos()函数，它返回子字符串首次出现的索引，若未找到则返回false，需用!== false进行严格比较以避免将0误判为不存在。对于区分大小写的场景，直接使用strpos()；不区分大小写时推荐stripos()，比手动转换大小写更高效。处理多字节字符（如中文）时应使用mb_strpos()和mb_stripos()，并显式指定编码（如UTF-8），以避免字节操作导致的乱码或错误。PHP 8引入了str_contains()函数，语义清晰，直接返回true或false，简化了包含判断，但仅限8.0以上版本使用。此外，preg_match()适用于复杂模式匹配，strstr()/stristr()可用于获取子串后续内容，但判断存在性时不如strpos()轻量。最佳实践是根据PHP版本、字符编码、大小写敏感性和匹配复杂度选择合适方法。

在PHP中，检查一个字符串是否包含另一个字符串的核心方法是利用内置的字符串函数，例如strpos()或strstr()。这些函数能够帮助我们定位子字符串，并通过其返回值来判断包含关系。对于PHP 8及更高版本，str_contains()函数提供了更直接、语义更清晰的判断方式。

解决方案

判断PHP字符串是否包含另一个字符串最常用且高效的方式是使用strpos()函数。这个函数会返回子字符串在主字符串中第一次出现的位置（索引），如果找不到，则返回false。

<?php
$mainString = "Hello, world! This is a PHP example.";
$subString1 = "world";
$subString2 = "PHP";
$subString3 = "Python";

// 检查是否包含 'world'
if (strpos($mainString, $subString1) !== false) {
    echo "'{$mainString}' 包含 '{$subString1}'\n"; // 输出: 'Hello, world! This is a PHP example.' 包含 'world'
} else {
    echo "'{$mainString}' 不包含 '{$subString1}'\n";
}

// 检查是否包含 'PHP'
if (strpos($mainString, $subString2) !== false) {
    echo "'{$mainString}' 包含 '{$subString2}'\n"; // 输出: 'Hello, world! This is a PHP example.' 包含 'PHP'
} else {
    echo "'{$mainString}' 不包含 '{$subString2}'\n";
}

// 检查是否包含 'Python'
if (strpos($mainString, $subString3) !== false) {
    echo "'{$mainString}' 包含 '{$subString3}'\n";
} else {
    echo "'{$mainString}' 不包含 '{$subString3}'\n"; // 输出: 'Hello, world! This is a PHP example.' 不包含 'Python'
}
?>

核心点在于 !== false。 因为strpos()在子字符串出现在主字符串开头时会返回0，而0在PHP的弱类型比较中会被视为false。因此，使用严格比较运算符!==来区分子字符串在开头的情况和完全不存在的情况至关重要。

PHP字符串包含判断：区分大小写与不区分大小写的最佳实践是什么？

在实际开发中，我们经常会遇到需要区分大小写或不区分大小写地检查字符串包含关系的需求。这两种场景各有其最佳实践方法。

区分大小写（Case-sensitive）

默认情况下，strpos()就是区分大小写的。这意味着 "Hello" 不包含 "hello"。

<?php
$text = "Apple Pie";
if (strpos($text, "apple") !== false) {
    echo "包含 'apple' (区分大小写)\n";
} else {
    echo "不包含 'apple' (区分大小写)\n"; // 输出: 不包含 'apple' (区分大小写)
}
?>

我个人在写代码时，如果对大小写有明确要求，通常会直接用 strpos。这种直接性避免了额外的转换开销，也更符合预期。

不区分大小写（Case-insensitive）

对于不区分大小写的判断，PHP提供了stripos()函数。它的用法和strpos()几乎一样，只是在比较时忽略了字符的大小写。

<?php
$text = "Apple Pie";
if (stripos($text, "apple") !== false) {
    echo "包含 'apple' (不区分大小写)\n"; // 输出: 包含 'apple' (不区分大小写)
} else {
    echo "不包含 'apple' (不区分大小写)\n";
}
?>

如果用户输入可能大小写混淆，stripos就省心多了，不用额外处理转换。另一种不区分大小写的做法是先将两个字符串都转换为小写（或大写），再使用strpos()：

<?php
$text = "Apple Pie";
$search = "apple";
if (strpos(strtolower($text), strtolower($search)) !== false) {
    echo "包含 'apple' (通过转换大小写实现不区分大小写)\n"; // 输出: 包含 'apple' (通过转换大小写实现不区分大小写)
}
?>

虽然这种方法也能达到目的，但通常stripos()更简洁高效，因为它避免了创建新的字符串副本。

PHP处理多字节字符串包含判断：如何避免乱码和错误？

当处理包含中文、日文、韩文或其他非ASCII字符的多字节字符串时，strpos()和stripos()可能会出现问题。这是因为它们是基于字节进行操作的，而不是基于字符。一个中文字符可能由多个字节组成，strpos()可能会错误地在字符中间找到“子串”，导致判断失误或乱码问题。

为了正确处理多字节字符串，PHP提供了mb_strpos()和mb_stripos()函数（mb_前缀代表"MultiByte"）。使用它们时，最好明确指定字符串的编码，以确保准确性。

<?php
// 确保PHP环境已启用mbstring扩展
// ini_set('default_charset', 'UTF-8'); // 通常在php.ini中设置
// mb_internal_encoding("UTF-8"); // 也可以在代码中设置内部编码

$mainString = "你好世界，这是一个PHP示例。";
$subString1 = "世界";
$subString2 = "PHP";
$subString3 = "Python";

// 使用 mb_strpos 区分大小写判断
if (mb_strpos($mainString, $subString1, 0, 'UTF-8') !== false) {
    echo "'{$mainString}' 包含 '{$subString1}' (多字节区分大小写)\n"; // 输出: '你好世界，这是一个PHP示例。' 包含 '世界' (多字节区分大小写)
}

// 使用 mb_stripos 不区分大小写判断
$mainStringCase = "Hello世界，这是一个php示例。";
$subStringCase = "php";
if (mb_stripos($mainStringCase, $subStringCase, 0, 'UTF-8') !== false) {
    echo "'{$mainStringCase}' 包含 '{$subStringCase}' (多字节不区分大小写)\n"; // 输出: 'Hello世界，这是一个php示例。' 包含 'php' (多字节不区分大小写)
} else {
    echo "'{$mainStringCase}' 不包含 '{$subStringCase}' (多字节不区分大小写)\n";
}
?>

这块我踩过坑，尤其是处理中文、日文这类字符串时，一开始没注意 mb_* 函数，结果判断出来的结果总是不对劲，排查半天才发现是编码问题。所以，凡是涉及到非ASCII字符，mb_系列函数几乎是标配。mb_strpos()和mb_stripos()的第四个参数是可选的编码参数，明确指定编码（如'UTF-8'）是一个非常好的习惯，它能避免依赖mb_internal_encoding()的全局设置，让代码更加健壮。

除了基本函数，PHP还有哪些高级或灵活的字符串包含判断方法？

除了上述的strpos系列和mb_strpos系列函数，PHP还提供了一些更高级或在特定场景下更灵活的字符串包含判断方法。

1. preg_match() (正则表达式)

当你的判断逻辑不仅仅是简单的子字符串匹配，而是涉及更复杂的模式（比如“以某个词开头”、“包含数字和字母的组合”等）时，正则表达式就成了不二之选。preg_match()函数可以用来检查一个字符串是否匹配某个正则表达式模式。

<?php
$text = "My email is test@example.com.";
$pattern1 = '/email/'; // 查找 "email"
$pattern2 = '/[0-9]+/'; // 查找一个或多个数字
$pattern3 = '/^[A-Za-z]+/'; // 查找以字母开头的字符串
$pattern4 = '/test@example\.com/i'; // 不区分大小写查找邮箱地址

if (preg_match($pattern1, $text)) {
    echo "文本包含 'email' (通过正则)\n"; // 输出: 文本包含 'email' (通过正则)
}

if (preg_match($pattern2, $text)) {
    echo "文本包含数字 (通过正则)\n";
} else {
    echo "文本不包含数字 (通过正则)\n";
}

if (preg_match($pattern4, $text)) {
    echo "文本包含邮箱地址 (通过正则不区分大小写)\n"; // 输出: 文本包含邮箱地址 (通过正则不区分大小写)
}
?>

有时候，简单的 strpos 满足不了需求，比如我想找的是 'cat' 或者 'dog'，或者开头是 'abc' 后面跟任意字符。这时候，正则表达式就成了我的首选。虽然学习成本高一点，但一旦掌握，字符串处理能力简直是质的飞跃。preg_match()返回1表示匹配成功，0表示不匹配，false表示发生错误。

2. strstr() / stristr()

strstr()函数（以及其不区分大小写的版本stristr()）也可以用于判断字符串包含。它们返回子字符串从第一次出现到主字符串末尾的部分，如果找不到子字符串，则返回false。因此，你可以通过检查返回值是否为false来判断包含关系。

<?php
$mainString = "The quick brown fox jumps over the lazy dog.";
$subString = "fox";

if (strstr($mainString, $subString) !== false) {
    echo "包含 '{$subString}' (通过 strstr)\n"; // 输出: 包含 'fox' (通过 strstr)
}

// stristr() 不区分大小写
if (stristr($mainString, "FOX") !== false) {
    echo "包含 'FOX' (通过 stristr)\n"; // 输出: 包含 'FOX' (通过 stristr)
}
?>

我个人用 strstr 比较少，通常是需要获取子串之后的部分内容时才会考虑。如果只是判断存不存在，strpos 更直观，也更轻量。

3. str_contains() (PHP 8+)

对于PHP 8及更高版本，PHP引入了一个新的函数str_contains()，它专门用于判断一个字符串是否包含另一个字符串。这个函数直接返回true或false，语义非常清晰，避免了!== false的写法。

<?php
// 仅限 PHP 8 及更高版本
if (version_compare(PHP_VERSION, '8.0.0', '>=')) {
    $mainString = "Hello PHP 8!";
    $subString = "PHP 8";

    if (str_contains($mainString, $subString)) {
        echo "包含 '{$subString}' (通过 str_contains)\n"; // 输出: 包含 'PHP 8' (通过 str_contains)
    } else {
        echo "不包含 '{$subString}' (通过 str_contains)\n";
    }

    // str_contains 是区分大小写的
    if (str_contains($mainString, "php")) {
        echo "包含 'php' (通过 str_contains)\n";
    } else {
        echo "不包含 'php' (通过 str_contains)\n"; // 输出: 不包含 'php' (通过 str_contains)
    }
} else {
    echo "当前PHP版本低于8.0，不支持 str_contains()。\n";
}
?>

PHP 8 引入的 str_contains 简直是福音！终于有一个函数是专门干这事的了，语义清晰，不用再 !== false 了。虽然老项目可能还用不上，但新项目我肯定会优先考虑它。不过需要注意的是，str_contains()是区分大小写的，如果需要不区分大小写，你仍然需要结合strtolower()或strtoupper()来使用。

选择哪种方法取决于你的具体需求：简单的区分大小写判断用strpos()，不区分大小写用stripos()，多字节字符用mb_strpos()/mb_stripos()，复杂模式用preg_match()，而PHP 8+项目则优先考虑str_contains()。

今天关于《PHP判断字符串是否包含指定内容的方法》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！