PHP字符串子串查找需据场景选函数：strpos/stripos查位置（注意false判断），preg_match_all找所有位置（支持正则），str_contains（8.0+）判存在，strstr/stristr作切片提取。
PHP 中查找字符串子串，核心是理解不同函数的适用场景和底层逻辑，而不是死记硬背。关键看是否需要位置、是否区分大小写、是否支持正则、是否要全字匹配。
基础位置查找：strpos 与 stripos
strpos() 是最常用的子串位置查找函数，区分大小写，返回首次出现的起始下标（从 0 开始），未找到返回 false。注意不能用 == false 判断失败，必须用 !== false 或 === false，因为位置 0 也是合法结果。
stripos() 是其不区分大小写的版本，行为完全一致，只是忽略字母大小写。
- 推荐写法：if (strpos($str, $substr) !== false) { ... }
- 可选第三个参数：指定搜索起始偏移量，例如 strpos($str, 'a', 5) 从第 5 个字符开始找
- 不支持正则，纯字符串逐字节匹配，性能高，适合绝大多数简单查找
查找所有匹配位置：preg_match_all
当需要找出子串在字符串中**所有出现的位置**（不止第一个），且可能带模式（如“数字+字母”、“邮箱片段”等），就该用 preg_match_all() 配合正则表达式。
立即学习“PHP免费学习笔记（深入）”；
- 使用 PREG_OFFSET_CAPTURE 标志可直接获取每个匹配的起始位置
- 示例：preg_match_all('/ab/', $str, $matches, PREG_OFFSET_CAPTURE); → $matches[0] 的每个元素形如 ['ab', 12]，第二个值就是偏移量
- 注意：正则有开销，纯固定字符串查找时，比 strpos 慢不少，别滥用
存在性判断：str_contains（PHP 8.0+）
PHP 8.0 引入了 str_contains()，语义最清晰：只关心“有没有”，返回布尔值，不关心在哪。它内部就是封装了 stripos（不区分大小写）或自定义逻辑，但调用简洁、可读性强。
- 写法：if (str_contains($str, $substr)) { ... }
- 不兼容低版本？可用 function_exists('str_contains') ? ... : (stripos($str, $substr) !== false) 兜底
- 不返回位置，也不支持偏移控制，定位需求请回退到 strpos
边界敏感查找：strstr 与 stristr
如果目标不是“位置”而是“取出子串及之后的部分”，或“取出子串之前的部分”，strstr() 更合适。它返回从第一次匹配处开始的**剩余子串**（含匹配内容），未找到返回 false。
- strstr($str, 'x') 返回从第一个 'x' 开始到末尾的字符串；加第三个参数 true 则返回 'x' 之前的部分
- stristr() 是其不区分大小写版
- 本质是“切片”操作，不是“查找”，但常被用于间接判断存在性或提取上下文
