PHP 字符串包含判断：从 strpos 到 str_contains，全面掌握子串查找与匹配技巧112

在 PHP 编程中，判断一个字符串是否包含另一个子字符串是一个极其常见且基础的操作。无论是处理用户输入、解析日志文件、构建路由系统还是进行数据验证，这项技能都无处不在。PHP 提供了多种灵活且强大的函数来完成这项任务，从经典的 `strpos()` 到 PHP 8 新增的 `str_contains()`，再到功能强大的正则表达式。作为一名专业的程序员，熟练掌握这些方法的异同、适用场景以及性能考量至关重要。

本文将深入探讨 PHP 中判断字符串包含的各种方法，包括它们的基本用法、参数、返回值、性能差异、案例敏感性以及在多字节字符（如中文）处理时的注意事项。通过本文，您将能够根据实际需求，选择最合适、最高效的字符串查找与匹配方案。

1. 最常用的方法：`strpos()` 和 `stripos()`

`strpos()` 是 PHP 中用于查找子字符串的“老牌”函数，它在给定字符串中查找第一次出现子字符串的位置。如果找到，它会返回子字符串在主字符串中开始的数字位置（偏移量）；如果没有找到，则返回布尔值 `false`。理解其返回值的特性是正确使用它的关键。

`strpos(string $haystack, string $needle, int $offset = 0): int|false`
`$haystack`: 在其中进行搜索的主字符串。
`$needle`: 要查找的子字符串。
`$offset`: 可选参数，指定从 `haystack` 的哪个字符位置开始搜索，默认为 0（从头开始）。

关键点：严格比较 `!== false`

由于 `strpos()` 在子字符串位于主字符串开头时会返回 `0`（这是一个有效的索引位置），而 `0` 在布尔上下文中会被视为 `false`，因此，直接使用 `if (strpos($haystack, $needle))` 来判断会导致错误的结果。正确的做法是使用严格的比较运算符 `!== false` 或 `=== false`。```php

2025-10-20

上一篇：PHP 数组倒序详解：深入理解 `array_reverse()` 及多种实现方法

下一篇：阿里云PHP应用部署与优化实战：从文件管理到性能飞跃