PHP字符串包含字符的奥秘：从基础函数到高级正则的全面指南118

在PHP编程中，判断一个字符串是否包含某个特定的字符或子字符串是一个极其常见且基础的操作。无论是数据验证、内容过滤、URL解析还是日志分析，这项能力都无处不在。随着PHP版本的迭代，我们有了更多、更高效、更直观的方法来完成这项任务。本文将深入探讨PHP中检查字符串是否包含字符的各种方法，从传统的函数到PHP 8.0引入的新特性，再到强大的正则表达式，并详细分析它们的特点、适用场景、性能考量以及多字节字符集下的处理方式，旨在为开发者提供一个全面而深入的参考。

一、PHP字符串包含字符的基础方法：strpos()与stripos()

strpos() 是PHP中用于查找子字符串首次出现位置的经典函数。它的核心功能是返回子字符串在主字符串中首次出现的数字位置（偏移量）。如果子字符串不存在，则返回 false。

函数签名：

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

其中：
$haystack: 在其中进行查找的字符串。
$needle: 要查找的子字符串。
$offset: 可选参数，指定从 $haystack 的哪个位置开始查找，默认为0。

1. 使用 strpos() 判断

关键点： strpos() 返回的是子字符串的起始位置（从0开始），如果子字符串位于字符串的开头，它将返回 0。由于 0 在布尔上下文中会被视为 false，因此在判断时，必须使用严格比较运算符 === 或 !== 来区分“未找到”和“在开头找到”。<?php
$text = "Hello, world! Welcome to PHP.";
$char = "world";
$char_at_start = "Hello";
$char_not_found = "php"; // 注意大小写
// 查找 "world"
if (strpos($text, $char) !== false) {
echo "字符串 '$text' 包含 '$char'."; // 输出：包含 'world'
} else {
echo "字符串 '$text' 不包含 '$char'.";
}
// 查找 "Hello" (在开头)
if (strpos($text, $char_at_start) !== false) {
echo "字符串 '$text' 包含 '$char_at_start'."; // 输出：包含 'Hello'
} else {
echo "字符串 '$text' 不包含 '$char_at_start'.";
}
// 查找 "php" (大小写敏感，未找到)
if (strpos($text, $char_not_found) !== false) {
echo "字符串 '$text' 包含 '$char_not_found'.";
} else {
echo "字符串 '$text' 不包含 '$char_not_found'."; // 输出：不包含 'php'
}
?>

2. 使用 stripos() 进行大小写不敏感查找

stripos() 是 strpos() 的大小写不敏感版本。它的用法和返回结果与 strpos() 完全一致，只是在查找时忽略大小写。

函数签名：

stripos(string $haystack, string $needle, int $offset = 0): int|false<?php
$text = "Hello, world! Welcome to PHP.";
$char_case_insensitive = "php";
// 查找 "php" (大小写不敏感)
if (stripos($text, $char_case_insensitive) !== false) {
echo "字符串 '$text' 包含 (不区分大小写) '$char_case_insensitive'."; // 输出：包含 'php'
} else {
echo "字符串 '$text' 不包含 (不区分大小写) '$char_case_insensitive'.";
}
?>

总结： strpos() 和 stripos() 是最基本、性能最好的查找方法之一，适用于简单的子字符串是否存在判断。它们的缺点在于需要进行 !== false 的严格比较，代码略显冗长。

二、PHP字符串包含字符的替代方法：strstr()与stristr()

strstr() 函数用于查找子字符串在主字符串中的首次出现。与 strpos() 不同的是，如果找到，它会返回 $needle 及其之后的部分；如果未找到，则返回 false。

函数签名：

strstr(string $haystack, string $needle, bool $before_needle = false): string|false

其中：
$haystack, $needle: 同 strpos()。
$before_needle: 可选参数，如果设置为 true，则返回 $needle 之前的部分。默认为 false。

1. 使用 strstr() 判断

<?php
$text = "Email: user@";
$separator = "@";
if (strstr($text, $separator) !== false) {
echo "字符串 '$text' 包含 '$separator'."; // 输出：包含 '@'
$domain_part = strstr($text, $separator);
echo "域名部分: " . $domain_part . ""; // 输出：@
$user_part = strstr($text, $separator, true);
echo "用户部分: " . $user_part . ""; // 输出：Email: user
} else {
echo "字符串 '$text' 不包含 '$separator'.";
}
?>

2. 使用 stristr() 进行大小写不敏感查找

stristr() 是 strstr() 的大小写不敏感版本，用法和返回结果与 strstr() 类似。

总结： strstr() 和 stristr() 不仅能判断是否存在，还能方便地获取匹配部分或之前的部分，在某些场景下非常有用，例如提取邮箱地址的域名或用户名。但如果只是简单地判断存在性，它们的效率通常不如 strpos() 系列函数。

三、PHP 8.0+ 的现代方法：str_contains()

PHP 8.0 引入了 str_contains() 函数，它以最直观、最语义化的方式解决了字符串包含判断的问题。它直接返回一个布尔值，无需进行 !== false 的比较，极大地提升了代码的可读性和简洁性。

函数签名：

str_contains(string $haystack, string $needle): bool

使用 str_contains() 判断

<?php
// 假设 PHP 版本 >= 8.0
$text = "PHP 8.0 brings great improvements.";
$keyword = "8.0";
$non_existent = "Python";
$case_sensitive_fail = "php"; // str_contains 区分大小写
if (str_contains($text, $keyword)) {
echo "字符串 '$text' 包含 '$keyword'."; // 输出：包含 '8.0'
} else {
echo "字符串 '$text' 不包含 '$keyword'.";
}
if (str_contains($text, $non_existent)) {
echo "字符串 '$text' 包含 '$non_existent'.";
} else {
echo "字符串 '$text' 不包含 '$non_existent'."; // 输出：不包含 'Python'
}
if (str_contains($text, $case_sensitive_fail)) {
echo "字符串 '$text' 包含 '$case_sensitive_fail'.";
} else {
echo "字符串 '$text' 不包含 '$case_sensitive_fail'."; // 输出：不包含 'php'
}
?>

总结： str_contains() 是 PHP 8.0 及更高版本进行字符串包含判断的首选方法，因为它简洁、直观且易于阅读。然而，它区分大小写，且不适用于旧版PHP。

四、使用正则表达式：preg_match()

当查找的“字符”不仅仅是一个固定的子字符串，而是符合某种模式（例如，包含任意数字、特殊符号、或者更复杂的文本结构）时，正则表达式是不可替代的工具。preg_match() 函数是PHP中用于执行正则表达式匹配的主要函数。

函数签名：

preg_match(string $pattern, string $subject, array &$matches = null, int $flags = 0, int $offset = 0): int|false

其中：
$pattern: 要搜索的正则表达式模式。
$subject: 在其中进行匹配的字符串。
$matches: 可选参数，如果提供，匹配结果将存储在这个数组中。

使用 preg_match() 判断

preg_match() 返回 1 表示找到匹配，0 表示未找到匹配，false 表示发生错误。<?php
$text = "用户ID: user123, 邮箱: test@";
// 1. 查找是否包含任何数字
if (preg_match('/\d/', $text)) {
echo "字符串 '$text' 包含数字."; // 输出：包含数字
} else {
echo "字符串 '$text' 不包含数字.";
}
// 2. 查找是否包含任何特殊字符 (非字母、数字、下划线)
if (preg_match('/[^a-zA-Z0-9_]/', $text)) {
echo "字符串 '$text' 包含特殊字符."; // 输出：包含特殊字符
} else {
echo "字符串 '$text' 不包含特殊字符.";
}
// 3. 查找是否包含 "邮箱:" 且后面跟着一个有效的邮箱格式 (简单示例)
if (preg_match('/邮箱:s*[\w.-]+@[\w.-]+\.[a-zA-Z]{2,}/', $text)) {
echo "字符串 '$text' 包含有效邮箱格式."; // 输出：包含有效邮箱格式
} else {
echo "字符串 '$text' 不包含有效邮箱格式.";
}
// 4. 大小写不敏感查找 'user'
if (preg_match('/user/i', $text)) { // /i 修正符表示不区分大小写
echo "字符串 '$text' (不区分大小写) 包含 'user'."; // 输出：包含 'user'
} else {
echo "字符串 '$text' (不区分大小写) 不包含 'user'.";
}
?>

总结： preg_match() 提供了无与伦比的灵活性和强大功能，适用于复杂的模式匹配需求。然而，正则表达式本身有学习曲线，且其性能通常低于简单的字符串函数。对于简单的子字符串查找，应优先考虑非正则函数。

五、多字节字符（UTF-8）的处理

上述的 strpos(), stripos(), strstr(), stristr(), str_contains() 函数都是字节安全的，这意味着它们会按照字节进行操作，而不是字符。对于只包含ASCII字符的字符串，这通常不是问题。但当处理包含中文、日文、韩文等UTF-8多字节字符的字符串时，这些函数可能会产生不正确的结果。

例如，一个中文字符可能由3个字节组成。如果使用 strpos() 查找一个单字节的子字符串，而主字符串中含有多字节字符，它的偏移量可能不是我们直观理解的“字符位置”。更严重的是，如果 needle 是一个多字节字符的“半截”（比如一个中文字符的第二个字节）， strpos() 可能会错误地匹配，导致乱码或逻辑错误。

为了正确处理多字节字符，PHP提供了MB（Multibyte String）系列函数。

1. mb_strpos() 与 mb_stripos()

这些函数是 strpos() 和 stripos() 的多字节版本，它们会根据指定的字符编码（默认为内部编码）来正确处理字符串。

函数签名：

mb_strpos(string $haystack, string $needle, int $offset = 0, ?string $encoding = null): int|false<?php
mb_internal_encoding("UTF-8"); // 设置内部字符编码为 UTF-8
$text_mb = "你好，世界！Hello, PHP。";
$char_mb = "世界";
$char_mb_not_found = "Python";
if (mb_strpos($text_mb, $char_mb) !== false) {
echo "多字节字符串 '$text_mb' 包含 '$char_mb'."; // 输出：包含 '世界'
} else {
echo "多字节字符串 '$text_mb' 不包含 '$char_mb'.";
}
// 查找大小写不敏感（例如英文字符，因为中文字符通常没有大小写之分）
if (mb_stripos($text_mb, "hello") !== false) {
echo "多字节字符串 '$text_mb' 包含 (不区分大小写) 'hello'."; // 输出：包含 'hello'
}
?>

2. mb_strstr() 与 mb_stristr()

同样，它们是 strstr() 和 stristr() 的多字节版本。

函数签名：

mb_strstr(string $haystack, string $needle, bool $before_needle = false, ?string $encoding = null): string|false

3. mb_ereg_match() (多字节正则表达式)

MBString扩展还提供了 mb_ereg_match() 等函数用于多字节字符串的正则表达式匹配。然而，通常情况下，Pcre（Perl Compatible Regular Expressions）函数如 preg_match() 结合 u 修正符（/pattern/u）也能很好地处理UTF-8字符串，并且Pcre函数通常更为推荐，因为它们功能更强大、性能更好。<?php
$text_mb = "你好，世界！Hello, PHP。";
// 使用 preg_match() 和 u 修正符处理 UTF-8 字符串中的中文字符
if (preg_match('/世界/u', $text_mb)) {
echo "使用 preg_match (UTF-8) 查找 '世界': 找到."; // 输出：找到
} else {
echo "使用 preg_match (UTF-8) 查找 '世界': 未找到.";
}
?>

总结： 在处理多字节字符（如UTF-8编码的中文）时，始终建议使用 mb_* 系列函数或带 u 修正符的 preg_* 函数，以确保字符的正确处理。

六、性能考量与最佳实践

在选择字符串查找方法时，性能是一个需要考虑的因素，尤其是在处理大量数据或高并发场景下。一般来说：
str_contains() (PHP 8.0+)： 最快，最简洁，推荐在兼容PHP 8.0+ 的项目中优先使用。
strpos() / stripos()： 性能非常高，仅次于 str_contains()。对于旧版PHP或需要获取位置的场景是最佳选择。
strstr() / stristr()： 性能略低于 strpos()，但如果你需要获取匹配部分或之前的部分，它很方便。
preg_match()： 性能最低，因为正则表达式引擎需要进行更复杂的模式匹配。仅在需要复杂模式匹配时使用。
mb_* 系列函数： 由于需要进行字符编码转换和处理多字节字符，性能会略低于其单字节对应函数，但为了正确性，在处理UTF-8等字符时是必须的。

何时选择哪种方法？

PHP 8.0+ 项目，简单判断是否存在： 使用 str_contains()。
PHP < 8.0 项目，简单判断是否存在，区分大小写： 使用 strpos($haystack, $needle) !== false。
PHP < 8.0 项目，简单判断是否存在，不区分大小写： 使用 stripos($haystack, $needle) !== false。
需要获取匹配子串之后或之前的部分： 使用 strstr() 或 stristr()。
需要进行复杂模式匹配，如查找数字、特殊字符、特定格式等： 使用 preg_match()。确保在模式中使用 u 修正符来支持UTF-8。
处理包含多字节字符（如中文）的字符串： 优先使用 mb_strpos(), mb_stripos() 或带 u 修正符的 preg_match()。

常见陷阱与最佳实践：

严格比较： 再次强调，使用 strpos() 等函数时，务必使用 !== false 或 === false 进行严格比较，以避免 0 被误判为 false。
字符编码： 在Web开发中，统一使用UTF-8编码并确保PHP内部编码设置正确（mb_internal_encoding("UTF-8");）是最佳实践。这能避免许多因编码问题导致的字符串处理错误。
可读性优先： 对于绝大多数应用，字符串查找的性能瓶颈并不常见。在性能差异不大的情况下，优先选择代码可读性最高的方法（如 str_contains()）。

七、结语

判断PHP字符串是否包含特定字符或子字符串是日常开发中不可或缺的技能。从基础的 strpos() 到简洁的 str_contains()，再到强大的 preg_match()，每种方法都有其独特的适用场景和优缺点。理解它们的工作原理，并在面对多字节字符时采取正确的处理方式，是成为一名高效且专业的PHP开发者的关键。通过本文的详细阐述和代码示例，相信您已经对PHP字符串包含字符的各种方法有了全面而深入的理解，能够根据实际需求选择最合适、最高效、最健壮的解决方案。

2025-10-24

上一篇：PHP数组查找终极指南：从基础到高效实践

下一篇：PHP与PostGIS深度集成：构建高性能地理空间Web应用的实践指南