大网数据广告活动
PHP 语言与运行手册

str_contains · 确定字符串是否包含指定子串

· 52CE 我爱测

str_ends_with() - 检查字符串是否以指定子串结尾 str_starts_with() - 检查字符串是否以指定子串开头 stripos() - 查找字符串首次出现的位置(不区分大小写) strrpos() - 计算指定字符串在目标字符串中最后一次出现的位置 strripos() - 计算指定字符串在目标字符串中最后一次出现的位置(不区分大小写) strstr() - 查找字符串的首次出现 strpbrk() - 在字符串中查找一组字符的任何一个字符 substr() - 返回字符串的子串 preg_match() - 执行匹配正则表达式

str_contains

(PHP 8)

str_contains — 确定字符串是否包含指定子串

说明

function str_contains(string $haystack, string $needle): bool

执行大小写区分的检查,表明 needle 是否包含在 haystack 中。

参数

haystack

在其中搜索的字符串。

needle

要在 haystack 中搜索的子串。

返回值

如果 needle 在 haystack 中,返回 true,否则返回 false。

示例

示例 #1 使用空字符串 ''

<?php
if (str_contains('abc', '')) {
    echo "Checking the existence of the empty string will always return true";
}
?>

以上示例会输出:

Checking the existence of the empty string will always return true

示例 #2 展示大小写区分

<?php
$string = 'The lazy fox jumped over the fence';

if (str_contains($string, 'lazy')) {
    echo "The string 'lazy' was found in the string\n";
}

if (str_contains($string, 'Lazy')) {
    echo 'The string "Lazy" was found in the string';
} else {
    echo '"Lazy" was not found because the case does not match';
}

?>

以上示例会输出:

The string 'lazy' was found in the string
"Lazy" was not found because the case does not match

注释

注意:

此函数可安全用于二进制对象。

参见

  • str_ends_with() - 检查字符串是否以指定子串结尾
  • str_starts_with() - 检查字符串是否以指定子串开头
  • stripos() - 查找字符串首次出现的位置(不区分大小写)
  • strrpos() - 计算指定字符串在目标字符串中最后一次出现的位置
  • strripos() - 计算指定字符串在目标字符串中最后一次出现的位置(不区分大小写)
  • strstr() - 查找字符串的首次出现
  • strpbrk() - 在字符串中查找一组字符的任何一个字符
  • substr() - 返回字符串的子串
  • preg_match() - 执行匹配正则表达式

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。