PHP字符串查找：判断字符或子串是否存在的全面指南253

在现代软件开发中，字符串处理是日常编程任务的核心。无论是用户输入验证、数据解析、文本搜索还是日志分析，我们都离不开对字符串内容的有效操作。其中，判断一个字符串是否包含某个特定的字符或子串，是最常见也是最基础的需求之一。

PHP作为一种广泛应用于Web开发的脚本语言，提供了多种强大而灵活的内置函数来处理字符串。理解这些函数的特性、适用场景、性能差异以及潜在的陷阱，对于编写高效、健壮且易于维护的代码至关重要。本文将深入探讨PHP中判断字符串是否包含特定字符或子串的各种方法，从基础函数到正则表达式，并提供最佳实践建议。

1. 引入：字符串包含判断的重要性

想象一下以下场景：
你需要检查用户输入的邮箱地址是否包含“@”符号。
你正在解析一个URL，需要判断它是否包含“”来确定是否为安全连接。
你编写了一个内容过滤器，需要识别文章中是否存在敏感词汇。
你处理文件路径，需要知道路径中是否包含特定的分隔符（如“/”或“\”）。

这些都离不开字符串的“包含”判断。PHP提供了从简单到复杂的多种解决方案，每种方案都有其独特的优势和适用场景。

2. 核心方法一：`strpos()` 和 `stripos()` – 查找子串首次出现的位置

`strpos()` 是PHP中最常用且效率最高的字符串查找函数之一。它的主要作用是查找指定子串在另一个字符串中首次出现的位置。如果找到了，它会返回子串的起始位置（从0开始计数）；如果没有找到，则返回 `false`。

2.1 `strpos()` 的基本用法

<?php
$haystack = "Hello, world! Welcome to PHP programming.";
$needle = "world";
if (strpos($haystack, $needle) !== false) {
echo "'{$haystack}' 包含 '{$needle}'. <br>";
} else {
echo "'{$haystack}' 不包含 '{$needle}'. <br>";
}
$needle2 = "php"; // 小写
if (strpos($haystack, $needle2) !== false) {
echo "'{$haystack}' 包含 '{$needle2}'. <br>";
} else {
echo "'{$haystack}' 不包含 '{$needle2}'. <br>"; // 此处将输出不包含，因为strpos是大小写敏感的
}
$needle3 = "!";
if (strpos($haystack, $needle3) !== false) {
echo "'{$haystack}' 包含 '{$needle3}'. <br>";
} else {
echo "'{$haystack}' 不包含 '{$needle3}'. <br>";
}
// 查找单个字符
$char = "o";
if (strpos($haystack, $char) !== false) {
echo "'{$haystack}' 包含字符 '{$char}'. <br>";
} else {
echo "'{$haystack}' 不包含字符 '{$char}'. <br>";
}
// 注意：如果子串在开头，strpos会返回0。0在PHP中会被弱类型转换为false，所以必须使用 '!=' 或 '!=='
$startNeedle = "Hello";
if (strpos($haystack, $startNeedle) !== false) {
echo "'{$haystack}' 以 '{$startNeedle}' 开头. <br>"; // 正确
} else {
echo "'{$haystack}' 不以 '{$startNeedle}' 开头. <br>";
}
// 错误示范：如果使用 == false 或者 !strpos(...)
if (strpos($haystack, $startNeedle) == false) {
echo "错误判断：'{$haystack}' 不以 '{$startNeedle}' 开头. <br>"; // 竟然判断为false，因为0 == false
}
?>

关键点： `strpos()` 是大小写敏感的。最重要的是，当子串位于主字符串的开头时，`strpos()` 会返回 `0`。由于 `0` 在PHP的弱类型比较中会被视为 `false`，所以必须使用 严格比较运算符 `!== false` 来判断是否找到子串，否则可能会导致逻辑错误。

2.2 `stripos()` – 大小写不敏感的查找

如果你的查找需求是大小写不敏感的，那么 `stripos()` 函数是 `strpos()` 的完美替代。它的功能与 `strpos()` 完全相同，只是在进行查找时会忽略大小写。<?php
$haystack = "Hello, world! Welcome to PHP programming.";
$needle = "php"; // 小写
if (stripos($haystack, $needle) !== false) {
echo "'{$haystack}' (忽略大小写) 包含 '{$needle}'. <br>"; // 此处将输出包含
} else {
echo "'{$haystack}' (忽略大小写) 不包含 '{$needle}'. <br>";
}
$needle2 = "WORLD"; // 大写
if (stripos($haystack, $needle2) !== false) {
echo "'{$haystack}' (忽略大小写) 包含 '{$needle2}'. <br>"; // 此处将输出包含
} else {
echo "'{$haystack}' (忽略大小写) 不包含 '{$needle2}'. <br>";
}
?>

3. 核心方法二：`strstr()` 和 `stristr()` – 查找并返回子串之后的部分

`strstr()` 函数用于查找一个字符串在另一个字符串中的首次出现。如果找到了，它会返回从子串开始到主字符串结尾的部分；如果没有找到，则返回 `false`。

3.1 `strstr()` 的基本用法

<?php
$haystack = "test@";
$needle = "@";
$result = strstr($haystack, $needle);
if ($result !== false) {
echo "'{$haystack}' 包含 '{$needle}'. 邮箱后缀是: {$result}<br>"; // 输出：@
} else {
echo "'{$haystack}' 不包含 '{$needle}'. <br>";
}
$needle2 = "Example"; // 大写
if (strstr($haystack, $needle2) !== false) {
echo "'{$haystack}' 包含 '{$needle2}'. <br>";
} else {
echo "'{$haystack}' 不包含 '{$needle2}'. <br>"; // 此处将输出不包含，因为strstr是大小写敏感的
}
?>

关键点： `strstr()` 也是大小写敏感的，并且同样需要使用 `!== false` 进行严格判断。它的主要特点是返回找到的子串及其之后的所有内容，这在某些解析场景下非常有用，比如提取邮箱后缀或URL参数。

`strstr()` 还有一个可选的第三个参数 `$before_needle` (布尔值)。如果设置为 `true`，它将返回 `needle` 之前的部分，而不是之后的部分。<?php
$email = "user@";
$username = strstr($email, '@', true); // 设置为 true，返回 '@' 之前的部分
echo "用户名: {$username}<br>"; // 输出：用户名: user
?>

3.2 `stristr()` – 大小写不敏感的查找

与 `strpos()` 和 `stripos()` 类似，`stristr()` 是 `strstr()` 的大小写不敏感版本。<?php
$haystack = "test@";
$needle = "example"; // 小写
if (stristr($haystack, $needle) !== false) {
echo "'{$haystack}' (忽略大小写) 包含 '{$needle}'. <br>"; // 输出：@
} else {
echo "'{$haystack}' (忽略大小写) 不包含 '{$needle}'. <br>";
}
?>

4. 核心方法三：`str_contains()` – PHP 8+ 的专用函数

随着PHP语言的发展，为了提高代码的可读性和直观性，PHP 8.0 引入了一个专门用于判断字符串是否包含子串的函数：`str_contains()`。

4.1 `str_contains()` 的基本用法

<?php
// 要求 PHP 8.0 及以上版本
if (version_compare(PHP_VERSION, '8.0.0', '>=') && function_exists('str_contains')) {
$haystack = "Hello, world! Welcome to PHP programming.";
$needle = "world";
if (str_contains($haystack, $needle)) {
echo "'{$haystack}' 包含 '{$needle}'. <br>";
} else {
echo "'{$haystack}' 不包含 '{$needle}'. <br>";
}
$needle2 = "php"; // 小写
if (str_contains($haystack, $needle2)) {
echo "'{$haystack}' 包含 '{$needle2}'. <br>";
} else {
echo "'{$haystack}' 不包含 '{$needle2}'. <br>"; // 此处将输出不包含，str_contains是大小写敏感的
}
// 查找单个字符
$char = "o";
if (str_contains($haystack, $char)) {
echo "'{$haystack}' 包含字符 '{$char}'. <br>";
} else {
echo "'{$haystack}' 不包含字符 '{$char}'. <br>";
}
} else {
echo "当前PHP版本低于8.0，无法使用 str_contains()。<br>";
}
?>

优势： `str_contains()` 的主要优势在于其极高的可读性和简洁性。它直接返回 `true` 或 `false`，无需像 `strpos()` 那样与 `false` 进行严格比较，大大减少了出错的可能性。

限制： 默认情况下，`str_contains()` 是大小写敏感的。目前没有 `stri_contains()` 这样的对应函数。如果需要大小写不敏感的判断，你需要结合 `strtolower()` 或 `strtoupper()` 函数：<?php
// 要求 PHP 8.0 及以上版本
if (version_compare(PHP_VERSION, '8.0.0', '>=') && function_exists('str_contains')) {
$haystack = "Hello, world! Welcome to PHP programming.";
$needle = "PHP"; // 大写
// 大小写不敏感的判断
if (str_contains(strtolower($haystack), strtolower($needle))) {
echo "'{$haystack}' (忽略大小写) 包含 '{$needle}'. <br>";
} else {
echo "'{$haystack}' (忽略大小写) 不包含 '{$needle}'. <br>";
}
}
?>

5. 核心方法四：`preg_match()` – 正则表达式的强大力量

当你的查找需求变得复杂，不仅仅是简单的子串匹配，而是需要匹配某种模式时，正则表达式（Regular Expressions）就派上用场了。PHP通过 `preg_match()` 函数提供了强大的正则表达式支持。

5.1 `preg_match()` 的基本用法

<?php
$haystack = "Hello, world! Welcome to PHP programming.";
// 查找子串 "world"
if (preg_match('/world/', $haystack)) {
echo "'{$haystack}' 包含 'world' (通过正则). <br>";
}
// 查找大小写不敏感的 "php" (使用 'i' 修正符)
if (preg_match('/php/i', $haystack)) {
echo "'{$haystack}' 包含 'php' (大小写不敏感，通过正则). <br>";
}
// 查找是否包含数字
if (preg_match('/\d/', $haystack)) {
echo "'{$haystack}' 包含数字. <br>";
} else {
echo "'{$haystack}' 不包含数字. <br>";
}
// 查找是否包含至少一个字母或数字
if (preg_match('/[a-zA-Z0-9]/', $haystack)) {
echo "'{$haystack}' 包含字母或数字. <br>";
}
// 查找是否以 "Hello" 开头 (使用 '^' 锚点)
if (preg_match('/^Hello/', $haystack)) {
echo "'{$haystack}' 以 'Hello' 开头. <br>";
}
// 查找是否以 "programming." 结尾 (使用 '$' 锚点)
if (preg_match('/programming\.$/', $haystack)) { // 注意 '.' 需要转义
echo "'{$haystack}' 以 'programming.' 结尾. <br>";
}
?>

优势： `preg_match()` 的最大优势在于其灵活性和强大功能。它可以处理任何复杂的模式匹配需求，例如验证邮箱格式、手机号码、提取特定格式的数据等。

限制与注意事项：
性能开销： 正则表达式引擎通常比简单的字符串查找函数（如 `strpos()` 或 `str_contains()`）有更高的性能开销。对于简单的子串查找，应优先使用后者。
语法复杂性： 正则表达式的语法相对复杂，编写和调试可能更具挑战性。
特殊字符： 如果要查找的子串本身包含正则表达式中的特殊字符（如 `.`, `*`, `+`, `?`, `[`, `]`, `(`, `)`, `{`, `}`, `^`, `$`, `\`, `|`），则需要使用 `preg_quote()` 函数进行转义，以避免它们被解释为正则表达式的元字符。

<?php
$haystack = "What is the cost of $5.00?";
$needle = "$5.00"; // 包含特殊字符
// 错误：$会被解释为锚点，.会被解释为匹配任意字符
// if (preg_match('/' . $needle . '/', $haystack)) { ... }
// 正确：使用 preg_quote 转义特殊字符
$escapedNeedle = preg_quote($needle, '/'); // 第二个参数是正则表达式的分隔符
if (preg_match('/' . $escapedNeedle . '/', $haystack)) {
echo "'{$haystack}' 包含转义后的 '{$needle}'. <br>";
}
?>

6. 其他相关函数和技巧

6.1 `str_starts_with()`, `str_ends_with()` (PHP 8+)

PHP 8.0 还引入了两个更具描述性的函数来判断字符串是否以某个子串开头或结尾：<?php
// 要求 PHP 8.0 及以上版本
if (version_compare(PHP_VERSION, '8.0.0', '>=') && function_exists('str_starts_with')) {
$url = "/path/to/page";
if (str_starts_with($url, "")) {
echo "'{$url}' 是一个安全链接. <br>";
}
if (str_ends_with($url, "page")) {
echo "'{$url}' 以 'page' 结尾. <br>";
}
// 大小写敏感，需要手动处理
if (str_starts_with(strtolower($url), "http")) {
echo "'{$url}' (忽略大小写) 以 'http' 开头. <br>";
}
}
?>

这两个函数提高了代码的意图清晰度，并可能在内部实现上提供更好的性能，特别是对于多字节字符串。

6.2 `strpos()` 结合 `str_replace()` / `substr_count()`

虽然 `strpos()` 主要用于判断是否存在，但如果需要知道子串出现的次数，可以使用 `substr_count()`：<?php
$text = "The quick brown fox jumps over the lazy dog. The fox is quick.";
$count = substr_count($text, "fox");
echo "字符串中 'fox' 出现了 {$count} 次.<br>"; // 输出：2
$count_insensitive = substr_count(strtolower($text), strtolower("The"));
echo "字符串中 'The' (忽略大小写) 出现了 {$count_insensitive} 次.<br>"; // 输出：2
?>

7. 性能考量

对于大多数Web应用程序来说，代码的清晰度和可维护性往往比微观的性能优化更为重要。然而，了解不同函数的性能特征仍然是有益的，尤其是在处理大量数据或在循环中频繁执行字符串操作时。
`str_contains()` (PHP 8+)： 对于简单的子串判断，它是最高效且最推荐的方法。PHP内部经过高度优化。
`strpos()` / `stripos()`： 同样非常高效，是PHP 8.0 之前版本进行简单子串查找的最佳选择。
`strstr()` / `stristr()`： 性能与 `strpos()` 系列接近，但由于它们返回子串，如果仅仅需要判断是否存在，则可能略微多做了一些工作。
`preg_match()`： 正则表达式引擎的初始化和模式匹配过程相对复杂，因此对于简单的子串查找，它的性能开销通常远高于其他函数。只在需要复杂模式匹配时使用。

在实际开发中，除非遇到明显的性能瓶颈，否则应该优先选择最能表达意图且最易读的函数。

8. 最佳实践和选择指南

面对如此多的选项，如何选择最合适的函数呢？以下是一些建议：
PHP 8.0+ 的简单包含判断：

推荐：`str_contains($haystack, $needle)`
原因： 最直观、最简洁、性能最佳。


PHP < 8.0 的简单包含判断：

推荐：`strpos($haystack, $needle) !== false`
原因： 高效且广泛支持，但务必记住使用 `!== false`。


大小写不敏感的包含判断：

推荐：`stripos($haystack, $needle) !== false` (PHP < 8.0) 或 `str_contains(strtolower($haystack), strtolower($needle))` (PHP 8.0+)
原因： `stripos` 直接提供了不敏感功能。`str_contains` 需要手动转换大小写，但其简洁性依然使其在PHP 8+中成为一个好选择。


需要获取子串或其前后部分的判断：

推荐：`strstr($haystack, $needle)` 或 `stristr($haystack, $needle)`
原因： 当你不仅需要判断是否存在，还需要利用子串或其周围内容时，这些函数是理想选择。


复杂的模式匹配、验证或提取：

推荐：`preg_match('/pattern/modifier', $haystack)`
原因： 正则表达式提供了无与伦比的灵活性和强大功能，适用于匹配复杂的字符串模式。但要注意性能和转义特殊字符。


判断字符串是否以特定子串开头/结尾 (PHP 8.0+)：

推荐：`str_starts_with($haystack, $needle)` / `str_ends_with($haystack, $needle)`
原因： 语义清晰，直接表达意图。

9. 总结

PHP提供了丰富而强大的字符串处理函数，以应对各种判断字符串是否包含特定字符或子串的需求。从简单高效的 `strpos()` 和 `str_contains()`，到擅长截取字符串的 `strstr()`，再到无所不能的正则表达式 `preg_match()`，每种方法都有其最佳的适用场景。

作为专业的程序员，我们应该熟悉这些工具，并能够根据具体的业务需求、PHP版本和性能要求，明智地选择最合适的函数。始终优先考虑代码的可读性、可维护性，并在必要时才考虑性能优化。掌握了这些技巧，你就能更高效、更优雅地处理PHP中的字符串操作。

2025-10-21

---

上一篇：PHP字符串深度解析：高效获取、截取与处理单个字符

下一篇：PHP文件参数：深度解析URL查询、表单、文件上传及CLI命令行参数的接收与处理