在 PHP 编程中，字符串查找函数 strpos 与 strstr 是最常用的两类工具。本文从基本行为、参数边界以及进阶用法等维度展开对比，聚焦坑点与正确用法，帮助开发者在实际编码中快速做出选择并减少误判。
1. 基本行为对比
strpos 的核心含义是：在给定字符串中定位子串首次出现的位置，返回一个整数表示索引，若未找到则返回 false。与之对照，strstr 的核心含义是：在给定字符串中找到子串，并返回从该子串开始到字符串末尾的剩余部分，未找到时返回 false。这两者的返回值语义完全不同，决定了后续的条件判断方式也不同。
返回值类型的关键点在于对“0”和“false”的区分。在 strpos 的场景中，当子串位于字符串起始位置时，返回值是 0，这在布尔判断中会被误判为假。因此，判断是否找到子串时，务必使用严格比较（!==）而不是简单的逻辑非（!=）或隐式转换。
下面的代码演示了两种情况的差异：找到在起始位置与未找到的区别。
strstr 的行为则更直观：若找到子串，返回的是从子串开始一直到字符串末尾的子串，且返回的类型是一个字符串；如果未找到，返回 false。这一点在组合字符串时尤为重要，因为返回值的类型会直接影响后续的字符串拼接或截取逻辑。
示意性例子如下，帮助理解返回的不同结果：
1.1 返回值的实际含义
在实际编码中，strpos 的返回值通常用于计算偏移量或判断位置；而 strstr 的返回值常用于获取目标子串及其后的文本段。请注意，strpos 的返回值不等同于“是否包含子串”的布尔结果，必须通过严格比较来判断；strstr 的返回值若为非布尔值时，已经是目标子串及其后续文本。
1.2 常见对比小结
在“需要知道子串起始点”的场景优先考虑 strpos，并用 !== false 来判断；在“需要提取子串及其后续文本”的场景，则优先考虑 strstr，并注意返回值的类型。
2. 参数及边界的细节
除了工作方式的差异，strpos 与 strstr 的参数结构也有明显区别。理解这些参数及其边界条件，是避免误用的关键点。
2.1 区分大小写与辅助函数
strpos 默认是大小写敏感的查找；如果需要忽略大小写，可以使用辅助函数 stripos，它返回与 strpos 相同的结果但进行大小写不敏感的匹配。类似地，strstr 也有大小写相关的变体：stristr 是大小写不敏感版本。
这组函数的对比让你在处理用户输入、URL 路径或语言本地化文本时，能快速切换到合适的变体，降低错判的风险。
下面的示例展示了大小写敏感与不敏感的对比效果：
2.2 offset 与边界条件
strpos 支持第三个参数 $offset，用于指定从字符串中的某个位置开始继续查找。这个参数对大文本或重复模式查找很有用，但需要注意：偏移值越大，查找范围越窄，性能也会有差异。
strstr 同样支持第三个布尔参数 $before_needle，用于控制返回的是匹配点之后的文本，还是匹配点之前的文本。当 $before_needle 为 true 时，返回的是 起始文本 的前缀部分；为 false 时，返回的是从匹配点开始的后缀文本。
结合具体需求，正确设置这些参数可以避免额外的字符串截取操作，提升代码可读性与执行效率。
3. strstr 的特性与进阶用法
在实际项目中，strstr 常用于从某个锚文本提取剩余信息，或在日志、协议字符串中快速拆分。掌握其特性后，你可以用更简洁的语句实现复杂的文本抽取。
before_needle 参数的引入，使得你可以灵活选择返回的文本段落。若你仅需要判断子串是否存在，而不关心具体文本，可以把返回值直接与 false 做对比；若需要截取文本，strstr 结合边界条件即可完成。
以下示例演示了在提取前缀和后缀时的两种截取方式：
在高频日志处理、文本分析等场景中，结合 strpos/strstr 的不同返回值和参数组合，可以实现高效的字符串定位与分割逻辑。
