PHP字符串包含详解：strpos(), strstr(), str_contains() 及其应用338

在PHP开发中，字符串操作是家常便饭。判断一个字符串是否包含另一个字符串是其中非常常见的需求。PHP提供了多种函数来实现这个功能，每种函数都有其特点和适用场景。本文将深入探讨PHP中用于判断字符串包含的几种主要函数：`strpos()`，`strstr()`，`str_contains()`，并通过代码示例和性能比较，帮助你选择最合适的函数来解决你的问题。

1. `strpos()` 函数

`strpos()` 函数是最常用的字符串查找函数之一。它在给定的字符串中查找指定字符串的第一次出现位置。如果找到，则返回该字符串的起始位置（索引，从0开始）；如果没有找到，则返回 `false`。其语法如下：
strpos(string $haystack, string $needle, int $offset = 0): int|false

其中：
`$haystack`：要搜索的字符串（主字符串）。
`$needle`：要查找的字符串（子字符串）。
`$offset`：（可选）搜索的起始位置偏移量，默认为0。

示例：
$haystack = "This is a test string.";
$needle = "test";
$position = strpos($haystack, $needle);
if ($position !== false) {
echo "Found '$needle' at position $position"; // 输出: Found 'test' at position 10
} else {
echo "'$needle' not found.";
}

需要注意的是，`strpos()` 是区分大小写的。如果需要不区分大小写地查找，可以使用 `stripos()` 函数。

2. `strstr()` 函数

`strstr()` 函数与 `strpos()` 函数类似，但它返回的是从找到的子字符串开始到原字符串末尾的子串。如果没有找到，则返回 `false`。其语法如下：
strstr(string $haystack, string $needle, bool $before_needle = false): string|false

其中：
`$haystack`：要搜索的字符串。
`$needle`：要查找的字符串。
`$before_needle`：（可选）如果设置为 `true`，则返回找到的子字符串之前的部分；默认为 `false`，返回找到的子字符串及其之后的部分。

示例：
$haystack = "This is a test string.";
$needle = "test";
$result = strstr($haystack, $needle);
echo $result; // 输出: test string.
$result = strstr($haystack, $needle, true);
echo $result; // 输出: This is a

类似地，`stristr()` 函数提供不区分大小写的查找。

3. `str_contains()` 函数 (PHP 8.0+)

PHP 8.0 引入了 `str_contains()` 函数，它提供了一种更简洁、更易读的方式来检查字符串是否包含另一个字符串。如果包含，则返回 `true`；否则返回 `false`。其语法如下：
str_contains(string $haystack, string $needle): bool

示例：
$haystack = "This is a test string.";
$needle = "test";
if (str_contains($haystack, $needle)) {
echo "'$needle' found in '$haystack'"; // 输出: 'test' found in 'This is a test string.'
} else {
echo "'$needle' not found in '$haystack'";
}

`str_contains()` 函数简洁明了，并且其语义比 `strpos()` 更直观，更适合用于简单的包含判断。

4. 性能比较

虽然这三个函数都能实现字符串包含的判断，但在性能上略有差异。一般来说，`str_contains()` 的性能略优于 `strpos()`，而 `strstr()` 由于需要返回子串，性能相对较低。 然而，在大多数实际应用中，除非处理大量字符串，否则性能差异并不显著。

5. 选择哪个函数？

选择哪个函数取决于你的具体需求：
只需要判断是否包含，不需要知道位置：使用 `str_contains()` (PHP 8.0+)，简洁易读。
需要知道子字符串的位置：使用 `strpos()` 或 `stripos()`。
需要获取包含子字符串的部分字符串：使用 `strstr()` 或 `stristr()`。

总而言之，熟练掌握这些函数，能够让你在PHP字符串处理中更加得心应手，编写出高效简洁的代码。

2025-06-05

上一篇：HTML无法直接读取PHP文件：详解跨语言数据交互方法

下一篇：在SAE平台上高效搭建和管理PHP数据库