如何用 stripos 判断字符串中是否包含特定单词？

M66 2025-05-17

在 PHP 中，我们经常需要判断一个字符串是否包含另一个特定的单词或子串。这种操作在处理用户输入、过滤关键词、构建搜索功能等场景中非常常见。PHP 提供了一个非常实用的函数 —— stripos()，它可以帮助我们轻松完成这项任务。

一、什么是 stripos()？

stripos() 是 PHP 的一个字符串函数，用于查找某个子串在目标字符串中第一次出现的位置。它的最大特点是不区分大小写，这在实际应用中非常方便。

函数语法：

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

$haystack：要搜索的目标字符串。
$needle：要查找的子串。
$offset：（可选）从目标字符串的某个位置开始搜索。

如果找到了子串，stripos() 会返回它在目标字符串中的位置（从 0 开始），否则返回 false。

二、实际案例：判断字符串是否包含某个单词

我们来看一个简单的例子，判断一段文字中是否包含“PHP”这个词：

$text = "欢迎访问我们的网站：https://www.m66.net，我们专注于PHP开发！";

if (stripos($text, "php") !== false) {
    echo "文本中包含 PHP！";
} else {
    echo "文本中不包含 PHP。";
}

输出结果：

文本中包含 PHP！

注意这里使用了 !== false，而不是 == true，是因为 stripos() 返回的是位置（如位置 0），如果直接用 if (stripos(...)) 会出现判断错误的问题。

三、常见用途

关键词过滤：

$badWords = ['spam', '广告', '敏感词'];
$userInput = "这个链接 https://www.m66.net 是一个广告网站。";

foreach ($badWords as $word) {
    if (stripos($userInput, $word) !== false) {
        echo "检测到敏感词：$word\n";
    }
}

搜索提示功能：

假设你正在构建一个搜索功能，需要检查用户输入的关键词是否与某些文章标题匹配：

$keyword = "教程";
$titles = [
    "PHP 基础入门教程",
    "JavaScript 学习指南",
    "Python 数据分析",
];

foreach ($titles as $title) {
    if (stripos($title, $keyword) !== false) {
        echo "找到相关标题：$title\n";
    }
}

四、小结

stripos() 是 PHP 中一个非常有用的字符串函数，适用于大小写不敏感的字符串匹配场景。它可以用于关键词过滤、搜索功能、数据验证等多个实际开发场景中。只要掌握了它的返回值特点，并正确使用 !== false 进行判断，就能高效地判断字符串是否包含某个特定单词。

掌握这一函数，能让你的 PHP 字符串处理更加灵活、高效！

stripos