php 字符串包含|极客教程

php 字符串包含

在编程语言中，字符串处理是一项非常基础且常见的任务。在 PHP 中，字符串是最常用的数据类型之一，并且提供了丰富的字符串处理函数和方法。其中之一就是字符串包含（string contains）。

字符串包含是指判断一个字符串是否包含指定的内容。在实际开发中，我们经常需要对字符串进行包含判断，例如判断一个文本中是否包含某个关键词，或者判断一个 URL 是否包含某个子串等。在 PHP 中，有多种方法可以实现字符串包含的功能。本文将详细介绍 PHP 中字符串包含的方法和用法。

strpos 函数

PHP 提供了一个用于查找字符串首次出现的位置的内置函数 strpos。该函数的使用格式如下：

int strpos ( string haystack , mixedneedle [, int $offset = 0 ] )

这个函数接受三个参数：

$haystack：要查找的字符串。
$needle：要搜索的子串。
$offset：可选参数，指定搜索的起始位置，默认值为 0。

strpos 函数会返回 $needle 在 $haystack 中首次出现的位置。如果 $needle 不在 $haystack 中，则返回 false。

下面是一个示例代码，演示了如何使用 strpos 函数判断字符串包含：

$text = 'Hello, World!';
$search = 'World';

if (strpos($text, $search) !== false) {
    echo '字符串包含关键词';
} else {
    echo '字符串不包含关键词';
}

运行结果为：

字符串包含关键词

stripos 函数

与 strpos 函数类似，stripos 函数也用于查找字符串首次出现的位置。但不同的是，stripos 函数是不区分大小写的。这意味着它在判断字符串包含时不考虑字符的大小写。

stripos 函数的使用格式如下：

int stripos ( string haystack , mixedneedle [, int $offset = 0 ] )

参数和返回值与 strpos 函数相同。下面是一个使用 stripos 函数的示例：

$text = 'Hello, World!';
$search = 'world';

if (stripos($text, $search) !== false) {
    echo '字符串包含关键词';
} else {
    echo '字符串不包含关键词';
}

运行结果为：

字符串包含关键词

strstr 函数

strstr 函数用于查找字符串中某个子串的第一次出现，并返回从该子串开始到字符串末尾的全部内容。使用格式如下：

string|bool strstr ( string haystack , mixedneedle [, bool $before_needle = false ] )

参数解释：

$haystack：要查找的字符串。
$needle：要搜索的子串。
$before_needle：可选参数，如果设置为 true，则返回 $needle 之前的内容；如果设置为 false，则返回 $needle 之后的内容，默认为 false。

下面是一个使用 strstr 函数的示例代码：

$text = 'Hello, World!';
$search = 'World';

$result = strstr($text, $search);

if ($result !== false) {
    echo '字符串包含关键词：' . $result;
} else {
    echo '字符串不包含关键词';
}

运行结果为：

字符串包含关键词：World!

stristr 函数

stristr 函数与 strstr 函数类似，但是不区分大小写。它用于查找字符串中某个子串的第一次出现，并返回从该子串开始到字符串末尾的全部内容。

stristr 函数的使用格式如下：

string|bool stristr ( string haystack , mixedneedle [, bool $before_needle = false ] )

参数和返回值与 strstr 函数相同。下面是一个使用 stristr 函数的示例：

$text = 'Hello, World!';
$search = 'world';

$result = stristr($text, $search);

if ($result !== false) {
    echo '字符串包含关键词：' . $result;
} else {
    echo '字符串不包含关键词';
}

运行结果为：

字符串包含关键词：World!

stripos 和 stristr 函数的性能比较

相比于 strpos 和 strstr 函数，stripos 和 stristr 函数的性能要稍差。因为 stripos 和 stristr 函数在进行字符串比较时需要进行大小写转换，而 strpos 和 strstr 函数则不需要。

在实际开发中，如果字符串包含判断的性能要求不高，可以使用 stripos 或 stristr 函数。但如果性能要求较高，可以优先考虑使用 strpos 或 strstr 函数。

preg_match 函数

除了上述的基本字符串处理函数外，PHP 还提供了正则表达式函数 preg_match，它可以用于更灵活的字符串包含判断。

preg_match 函数的使用格式如下：

int preg_match ( string pattern , stringsubject [, array &matches [, intflags = 0 [, int $offset = 0 ]]] )

参数解释：

$pattern：要匹配的正则表达式模式。
$subject：要匹配的字符串。
$matches：可选参数，如果提供了该参数，它将在函数执行后被填充为匹配结果。
$flags：可选参数，用于指定匹配模式，例如是否区分大小写等。默认值为 0。
$offset：可选参数，用于指定开始搜索的位置，默认值为 0。

下面是一个使用 preg_match 函数进行字符串包含判断的示例代码：

$text = 'Hello, World!';
$search = '/world/i';

if (preg_match($search, $text)) {
    echo '字符串包含关键词';
} else {
    echo '字符串不包含关键词';
}

运行结果为：

字符串包含关键词

在上述示例代码中，$search 使用了正则表达式模式 /world/i，其中 i 表示不区分大小写。因此，在判断字符串包含时，不考虑大小写的因素。

总结

本文介绍了 PHP 中字符串包含的几种常用方法，包括 strpos、stripos、strstr、stristr 和 preg_match 函数。它们分别适用于不同的场景，并且在性能方面有所差异。程序员可以根据实际需求选择合适的方法来进行字符串包含判断。

在使用字符串包含函数时，需要注意参数的正确使用，并处理函数返回值。同时，如果对性能有要求，可以优化函数的使用或考虑使用其他方法，如 substr_count 函数。

substr_count 函数用于计算字符串中某个子串出现的次数。它的使用格式如下：

int substr_count ( string haystack , stringneedle [, int offset = 0 [, intlength ]] )

参数解释：

$haystack：要查找的字符串。
$needle：要搜索的子串。
$offset：可选参数，指定搜索的起始位置，默认值为 0。
$length：可选参数，指定搜索的长度，默认为字符串的长度。

下面是一个使用 substr_count 函数判断字符串包含的示例代码：

$text = 'Hello, World!';
$search = 'o';

$count = substr_count($text, $search);

if ($count > 0) {
    echo '字符串包含关键词，出现了 ' . $count . ' 次';
} else {
    echo '字符串不包含关键词';
}

运行结果为：

字符串包含关键词，出现了 2 次

在上述示例代码中，$search 是要搜索的子串，$count 是子串在字符串中出现的次数。如果 $count 大于 0，就表示字符串包含了关键词。

除了以上介绍的方法外，还可以使用 str_contains 函数，它是 PHP 8 引入的新函数。str_contains 函数用于判断一个字符串是否包含另一个字符串，使用简单直观。使用格式如下：

bool str_contains ( string haystack , stringneedle )

下面是一个使用 str_contains 函数判断字符串包含的示例代码：

$text = 'Hello, World!';
$search = 'World';

if (str_contains($text, $search)) {
    echo '字符串包含关键词';
} else {
    echo '字符串不包含关键词';
}

运行结果为：

字符串包含关键词

在 PHP 8 之前，可以使用 strpos 函数进行替代，判断返回值是否为 false。

这篇文章介绍了 PHP 中常用的字符串包含方法，包括 strpos、stripos、strstr、stristr、preg_match、substr_count 和 str_contains 函数。这些方法可以根据实际需求选择合适的方法来进行字符串包含判断。在使用时，需要注意参数的正确使用，并根据返回值进行判断处理。