stristr是php中不区分大小写的子串查找函数，返回匹配位置起的剩余字符串或false；而strpos区分大小写且只返回整型位置索引。
stristr 是什么，和 strpos 有什么区别
stristr 是 PHP 的一个内置函数，用于**不区分大小写的子串查找**，返回从第一次匹配位置开始的剩余字符串（包括匹配部分），没找到则返回 false。它和 strpos 最关键的区别在于：后者只返回位置索引（int）且区分大小写；而 stristr 返回的是子串本身，且默认忽略大小写。
常见误用是拿它当“判断是否存在”的工具却忘了它返回的是字符串——直接用 if (stristr($a, $b)) 看似可行，但如果匹配内容恰好在开头（比如 "hello" 中找 "h"），返回 "hello"，作为布尔值为 true；但若被查找字符串为空或匹配项是 "0" 这类假值，逻辑可能意外中断。
基本用法和参数细节
stristr 接收两个必需参数：$haystack（被搜索字符串）和 $needle（要找的子串），PHP 7.3+ 还支持第三个可选参数 $before_needle（bool），设为 true 时返回匹配前的部分（不含 $needle）。
- 如果
$needle是空字符串（""），PHP 会发出警告并返回false -
$needle只能是字符串；传 int、array 或 null 会触发类型警告（PHP 8+ 是 TypeError） - 不支持正则，想用模式匹配得换
preg_match - 中文等多字节字符可用，但它是按字节比较的，不是按 UTF-8 字符——遇到带重音符号或 emoji 可能出错，这时该用
mb_stristr
示例：
echo stristr('Hello World', 'o'); // 输出 "o World"（从第一个 'o' 开始）
echo stristr('Email: user@EXAMPLE.COM', '@example'); // 能匹配，输出 "@EXAMPLE.COM"
为什么有时返回 false 却没报错
这是最常踩的坑：stristr 在找不到匹配项时返回布尔值 false，而不是空字符串 ""。如果你写了 $result = stristr($text, 'key') ?: ''，看起来安全，但万一 $text 是 null 或非字符串，stristr 本身就会触发 warning 并返回 false，不会进入你的 fallback。
- 务必确保
$haystack是字符串，可用(string)$haystack强转，或先is_string()判断 - 检查返回值要用严格比较：
if ($result !== false)，避免false == ''或false == 0带来的隐式转换陷阱 - 调试时别只
var_dump($result)，要看类型——var_dump(gettype($result))更可靠
替换成 mb_stristr 的实际条件
只要你的数据含中文、日文、emoji、带变音符号的西文（如 naïve、café），或者明确要求按“字符”而非“字节”匹配，就必须用 mb_stristr，并设置正确的编码（通常是 'UTF-8'）。
-
mb_stristr参数顺序和stristr一致，但第四个参数才是$before_needle - 没启用
mbstring扩展会 fatal error，上线前用function_exists('mb_stristr')检查 - 性能略低，但对用户输入、数据库读出的文本，这点开销远不如显示错乱代价大
示例：
echo mb_stristr('你好世界', '世界', true, 'UTF-8'); // 输出 "你好"
注意 stristr 的“不区分大小写”只对 ASCII 字母有效；遇到德语 ß、土耳其语 İ 等，它照样失灵——这种场景下连 mb_stristr 都不够，得上 iconv_strcasemap 或 ICU 扩展。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
