本教程详细阐述了在php中检测字符串是否包含特定子字符串的多种方法。针对`strpos`和`stripos`的正确用法，文章提供了清晰的指导，并重点介绍了`preg_match`结合正则表达式的强大功能。通过示例代码，教程演示了如何根据不同需求选择最合适的检测方案，包括php 8+的`str_contains()`，旨在提升代码的效率和可读性。
字符串子串检测概述
在PHP开发中，判断一个字符串是否包含另一个特定的子字符串是一项常见的操作。虽然有多种内置函数可以实现这一功能，但理解它们的差异和适用场景对于编写高效、健壮的代码至关重要。本文将深入探讨几种主要的子字符串检测方法，并提供实际示例。
方法一：使用 strpos() 或 stripos() 进行简单查找
strpos() 函数用于查找一个字符串在另一个字符串中首次出现的位置（区分大小写），而 stripos() 则执行不区分大小写的查找。如果找到子字符串，它们会返回其起始位置的偏移量（从0开始）；如果未找到，则返回 false。
关键注意事项： 由于子字符串可能出现在字符串的起始位置（即偏移量为0），这在布尔上下文中会被PHP解释为 false。因此，在使用 strpos() 或 stripos() 的返回值时，务必使用严格比较运算符 !== false 来判断是否找到子字符串。
示例代码：
<?php
$mainString = '-med prista-';
$subString = 'pris';
// 区分大小写查找
if (strpos($mainString, $subString) !== false) {
echo "'{$mainString}' 包含 '{$subString}' (strpos)。\n";
} else {
echo "'{$mainString}' 不包含 '{$subString}' (strpos)。\n";
}
// 不区分大小写查找
if (stripos($mainString, $subString) !== false) {
echo "'{$mainString}' 包含 '{$subString}' (stripos)。\n";
} else {
echo "'{$mainString}' 不包含 '{$subString}' (stripos)。\n";
}
// 示例：子字符串在开头
$mainString2 = 'apple pie';
$subString2 = 'apple';
if (strpos($mainString2, $subString2) !== false) {
echo "'{$mainString2}' 包含 '{$subString2}' (strpos)。\n"; // 正确输出
}
?>对于本教程开头提出的案例，strpos($mainString, $subString) !== false 完全可以胜任。
立即学习“PHP免费学习笔记（深入）”；
方法二：使用 preg_match() 进行正则表达式匹配
当需要进行更复杂的模式匹配，例如查找符合特定模式的子字符串，或者需要忽略大小写而不使用 stripos() 时，preg_match() 函数是理想的选择。它使用正则表达式作为匹配模式，提供了极大的灵活性。
功能与语法：preg_match(pattern, subject, matches, flags, offset)
- pattern: 要搜索的正则表达式。
- subject: 要搜索的输入字符串。
- matches (可选): 如果提供了，它将填充所有匹配项。
- flags (可选): 可用于修改匹配行为。
- offset (可选): 指定从 subject 的哪个位置开始搜索。
preg_match() 如果找到匹配项，则返回 1；如果没有找到，则返回 0；如果发生错误，则返回 false。
示例代码：
针对原始问题中“检查单词 pris 是否包含在字符串 -med prista- 中”的需求，preg_match() 提供了一个简洁而强大的解决方案：
<?php
$str = '-med prista-';
$pattern = '/pris/'; // 正则表达式模式，查找 'pris'
if (preg_match($pattern, $str)) {
echo "'{$str}' 包含 'pris' (preg_match)。\n";
} else {
echo "'{$str}' 不包含 'pris' (preg_match)。\n";
}
// 忽略大小写匹配
$strCase = 'PRISTINE';
$patternCaseInsensitive = '/pris/i'; // 添加 'i' 修饰符表示不区分大小写
if (preg_match($patternCaseInsensitive, $strCase)) {
echo "'{$strCase}' 包含 'pris' (preg_match, 忽略大小写)。\n";
} else {
echo "'{$strCase}' 不包含 'pris' (preg_match, 忽略大小写)。\n";
}
// 更复杂的模式：查找以 'a' 开头，后跟任意字符，再跟 'z' 的模式
$complexStr = 'alphabet';
if (preg_match('/a.*z/', $complexStr)) {
echo "'{$complexStr}' 包含 'a.*z' 模式。\n";
} else {
echo "'{$complexStr}' 不包含 'a.*z' 模式。\n";
}
?>preg_match 的优势：
- 灵活性： 能够匹配几乎任何复杂的字符串模式。
- 修饰符： 支持多种修饰符（如 i 用于不区分大小写，m 用于多行模式等）。
- 捕获匹配： 可以轻松捕获匹配到的子字符串或子模式。
性能考量： 对于简单的固定子字符串查找，strpos() 通常比 preg_match() 性能更高，因为正则表达式引擎需要额外的解析和处理开销。然而，对于需要正则表达式的场景，preg_match() 是不可替代的。
方法三：使用 str_contains() (PHP 8+)
从 PHP 8.0 开始，引入了一个更直观、更简洁的函数 str_contains()，专门用于判断一个字符串是否包含另一个子字符串。它返回一个布尔值 true 或 false。
示例代码：
<?php
if (version_compare(PHP_VERSION, '8.0.0', '>=')) {
$mainString = '-med prista-';
$subString = 'pris';
if (str_contains($mainString, $subString)) {
echo "'{$mainString}' 包含 '{$subString}' (str_contains)。\n";
} else {
echo "'{$mainString}' 不包含 '{$subString}' (str_contains)。\n";
}
} else {
echo "str_contains() 需要 PHP 8.0 或更高版本。\n";
}
?>str_contains() 是处理简单子字符串包含检查的最佳实践，因为它代码简洁，意图明确，并且性能优于 strpos 在某些边缘情况下的复杂判断。
方法四：使用 strstr() 或 stristr()
strstr() 函数查找一个字符串在另一个字符串中的首次出现，并返回从该子字符串开始到主字符串结尾的部分。如果未找到，则返回 false。stristr() 提供不区分大小写的版本。
与 strpos 的区别：strpos() 返回子字符串的起始位置，而 strstr() 返回匹配到的子字符串及之后的所有内容。如果只需要判断是否存在，它们都可以通过检查返回值是否为 false 来实现。
示例代码：
<?php
$mainString = '-med prista-';
$subString = 'pris';
if (strstr($mainString, $subString) !== false) {
echo "'{$mainString}' 包含 '{$subString}' (strstr)。\n";
} else {
echo "'{$mainString}' 不包含 '{$subString}' (strstr)。\n";
}
$result = strstr($mainString, $subString);
if ($result !== false) {
echo "从 'pris' 开始的部分是: {$result}\n"; // 输出: prista-
}
?>选择合适的检测方法
在选择字符串子串检测方法时，应根据具体需求进行权衡：
- 简单固定子串检测 (PHP 8+ 推荐)： 如果仅需判断一个固定子字符串是否存在，且项目环境支持 PHP 8.0 及以上，强烈推荐使用 str_contains()，它最直观且性能良好。
- 简单固定子串检测 (PHP 7.x 及更早版本)： 对于旧版 PHP，使用 strpos($haystack, $needle) !== false 是最佳选择。
- 复杂模式匹配或不确定性： 当需要匹配复杂的字符串模式（例如，以特定字符开头或结尾，包含数字或特殊符号等），或者需要利用正则表达式的强大功能时，preg_match() 是唯一的选择。
- 需要获取子串及之后的部分： 如果不仅需要判断是否存在，还需要获取从子字符串开始的剩余部分，strstr() 或 stristr() 会更方便。
总结
PHP 提供了多种灵活的工具来检测字符串是否包含子字符串。对于简单的、固定内容的查找，str_contains()（PHP 8+）或 strpos() 是高效且易于理解的选择。而当涉及到更复杂的模式或需要正则表达式的强大功能时，preg_match() 则是不可或缺的。理解这些函数的特点和适用场景，能够帮助开发者编写出更优化、更符合需求的字符串处理代码。
