strpos 函数与 stripos 函数的区别

在 PHP 的字符串处理函数中，strpos 和 stripos 是两个经常被使用的函数。它们看起来差不多，只差一个字母，但实际上却有一个关键的不同点。本文将带你从用法、区别、注意事项等方面彻底弄明白这两个函数的异同。

一、基本用法

strpos 和 stripos 的作用都是查找字符串在另一个字符串中第一次出现的位置。它们的基本语法如下：

strpos(string $haystack, mixed $needle, int $offset = 0): int|false
stripos(string $haystack, mixed $needle, int $offset = 0): int|false

• $haystack 是要搜索的目标字符串。

• $needle 是要查找的子字符串。

• $offset 是可选的，指定从哪个位置开始查找。

二、核心区别：是否区分大小写

这就是两者之间最大的区别：

• strpos 是 区分大小写 的。

• stripos 是 不区分大小写 的。

示例：

<?php
$str = "Hello World";

var_dump(strpos($str, "world"));  // 输出：bool(false)
var_dump(stripos($str, "world")); // 输出：int(6)
?>

在这个例子中，strpos 因为找不到小写的 "world" 而返回 false，而 stripos 不区分大小写，因此能正确找到位置 6。

三、返回值要小心

这两个函数都返回 整数（匹配位置） 或 false（没找到）。要注意的是，当匹配位置是 0 时（也就是子串在开头），用 == false 来判断是否匹配失败会出错。

错误写法：

if (strpos("abc", "a") == false) {
    echo "没找到";
}

输出将是：“没找到”——但其实是找到了。

正确写法：

if (strpos("abc", "a") === false) {
    echo "没找到";
}

始终使用全等 === 来判断是否为 false，以避免位置为 0 被误判。

四、常见应用场景

• strpos：你需要严格区分大小写的搜索，比如敏感词检测、关键命令匹配等。

• stripos：你希望搜索更宽松一些，比如处理用户输入、爬虫判断 UA、分析 URL 参数等。

例子：判断链接中是否包含特定关键词

<?php
$url = "https://gitbox.net/shop/product/123";

if (stripos($url, "/shop/") !== false) {
    echo "这是一个商品页面";
}
?>

在这个例子中，用 stripos 判断 URL 是否包含 /shop/ 关键词，不管大小写，能有效识别出用户访问的页面类型。

五、性能差别

在大部分常见使用中，两者的性能差距可以忽略不计。但如果你在一个大循环中频繁调用，并且字符串数量特别大，那么 strpos 会稍快一点，因为它少了一个大小写转换的过程。

六、小技巧和注意事项

1. 不要混用 strpos 和 stripos 的返回值来统一判断，注意区分大小写语义。

2. 如果你的搜索逻辑依赖用户输入，尽量用 stripos，更友好。

3. 使用 === false 判断是否匹配失败，不然容易被位置 0 误导。

七、总结

strpos 和 stripos 虽然只差一个小写的 i，但背后的逻辑决定了你是否能找到你想要的结果。在实际开发中，合理选择它们，能帮你避免不少 Bug。希望这篇文章能帮你真正掌握它们的区别，下次写代码不再犹豫！