PHP 字符串包含判断：从基础到高级，多字符与模式匹配深度解析351

```html

在PHP编程中，字符串操作是日常开发的核心任务之一。无论是处理用户输入、解析文件内容、构建URL，还是进行数据验证和过滤，判断一个字符串是否包含特定的字符、子串或字符集合，都是极其常见的需求。本文将作为一篇全面的指南，深入探讨PHP中判断字符串包含的各种方法，从基础函数到高级正则表达式，覆盖单字符、多字符、模式匹配以及多字节字符的处理，旨在帮助开发者选择最适合其场景的高效解决方案。

一、基础篇：判断字符串是否包含单个字符或子串

首先，我们从最简单的场景开始：判断一个字符串是否包含另一个单一的字符或子字符串。PHP提供了多个内置函数来完成这项任务。

1.1 `strpos()` 和 `stripos()`：查找子串首次出现的位置

这是PHP中最常用且效率最高的查找函数之一。`strpos()` 用于查找字符串中子串首次出现的位置，如果找到则返回该位置（从0开始），如果未找到则返回 `false`。`stripos()` 是其不区分大小写版本。<?php
$haystack = "Hello, world! This is a PHP string.";
$needle1 = "world";
$needle2 = "PHP";
$needle3 = "Python";
$needle4 = "hello"; // 小写，与原字符串大小写不符
// strpos() - 区分大小写
if (strpos($haystack, $needle1) !== false) {
echo "'$haystack' 包含 '$needle1'."; // 输出：'Hello, world! This is a PHP string.' 包含 'world'.
}
if (strpos($haystack, $needle2) !== false) {
echo "'$haystack' 包含 '$needle2'."; // 输出：'Hello, world! This is a PHP string.' 包含 'PHP'.
}
if (strpos($haystack, $needle3) === false) {
echo "'$haystack' 不包含 '$needle3'."; // 输出：'Hello, world! This is a PHP string.' 不包含 'Python'.
}
if (strpos($haystack, $needle4) === false) {
echo "'$haystack' 不包含 '$needle4' (区分大小写)."; // 输出：'Hello, world! This is a PHP string.' 不包含 'hello' (区分大小写).
}
echo "<h3>使用 stripos() (不区分大小写)</h3>";
// stripos() - 不区分大小写
if (stripos($haystack, $needle4) !== false) {
echo "'$haystack' 包含 '$needle4' (不区分大小写)."; // 输出：'Hello, world! This is a PHP string.' 包含 'hello' (不区分大小写).
}
?>

注意：由于 `0` 也是一个有效的位置（表示子串在字符串开头），所以必须使用严格的比较运算符 `!== false` 或 `=== false`，而不是 `!= false` 或 `== false`，以避免混淆。

1.2 `strstr()` 和 `stristr()`：查找子串并返回子串到结尾的部分

`strstr()` 函数返回 `haystack` 中从 `needle` 第一次出现的位置开始到 `haystack` 结尾的字符串。如果 `needle` 未找到，则返回 `false`。`stristr()` 是其不区分大小写版本。<?php
$email = "user@";
$domain = strstr($email, '@'); // $domain 将是 "@"
if ($domain !== false) {
echo "邮箱域名是: " . substr($domain, 1) . ""; // 输出：邮箱域名是:
}
$long_string = "The quick brown fox jumps over the lazy dog.";
if (strstr($long_string, "fox") !== false) {
echo "'$long_string' 包含 'fox'."; // 输出：'The quick brown fox jumps over the lazy dog.' 包含 'fox'.
}
?>

虽然 `strstr()` 可以用于判断包含，但其主要目的是截取字符串，因此对于单纯的包含判断，`strpos()` 通常更直接和高效。

1.3 `str_contains()`：PHP 8+ 的现代方法

PHP 8.0 引入了 `str_contains()` 函数，它专门用于判断字符串是否包含另一个字符串，返回布尔值 `true` 或 `false`，代码更简洁易读。它区分大小写。<?php
$text = "PHP 8 makes string operations easier.";
$search1 = "string";
$search2 = "php"; // 小写
$search3 = "Python";
if (str_contains($text, $search1)) {
echo "'$text' 包含 '$search1'."; // 输出：'PHP 8 makes string operations easier.' 包含 'string'.
}
if (!str_contains($text, $search2)) {
echo "'$text' 不包含 '$search2' (区分大小写)."; // 输出：'PHP 8 makes string operations easier.' 不包含 'php' (区分大小写).
}
if (!str_contains($text, $search3)) {
echo "'$text' 不包含 '$search3'."; // 输出：'PHP 8 makes string operations easier.' 不包含 'Python'.
}
?>

对于PHP 8及更高版本，`str_contains()` 是判断字符串是否包含子串的首选方法，因为它代码可读性好，且性能优异。

二、进阶篇：判断字符串是否包含“几种字符”（多个字符或子串）

当需求变得复杂，我们需要判断一个字符串是否包含多个特定的字符或子串时，情况就有所不同。这里可以分为两种主要场景：包含“任意一个”和包含“所有”。

2.1 场景一：判断是否包含“任意一个”指定字符/子串

这意味着只要字符串中存在我们给定列表中的任何一个字符或子串，就视为满足条件。

2.1.1 方法一：循环遍历与基础函数结合

这是最直观的方法，通过遍历一个包含所有待查找项的数组，逐一使用 `strpos()` 或 `str_contains()` 进行检查。<?php
$main_string = "Apple, Banana, Cherry";
$keywords = ["Orange", "Banana", "Grape"];
$found = false;
foreach ($keywords as $keyword) {
if (str_contains($main_string, $keyword)) { // PHP 8+
$found = true;
echo "'$main_string' 包含关键字 '$keyword'.";
break; // 找到任意一个即可退出
}
// 如果是PHP 7或更早版本，可以使用：
// if (strpos($main_string, $keyword) !== false) {
// $found = true;
// echo "'$main_string' 包含关键字 '$keyword'.";
// break;
// }
}
if ($found) {
echo "字符串包含至少一个指定关键字."; // 输出：字符串包含至少一个指定关键字.
} else {
echo "字符串不包含任何指定关键字.";
}
?>

2.1.2 方法二：正则表达式 `preg_match()`

正则表达式是处理复杂字符串模式匹配的瑞士军刀。使用 `preg_match()` 函数，并结合正则表达式的 `|` (或) 运算符或字符类 `[]`，可以高效地判断是否包含任意一个指定项。<?php
$text = "The quick brown fox jumps over the lazy dog.";
// 示例 1: 包含任意一个单词 ("fox", "cat", "bird")
if (preg_match("/fox|cat|bird/i", $text)) { // /i 表示不区分大小写
echo "'$text' 包含 'fox', 'cat' 或 'bird' 中的任意一个."; // 输出：包含
}
// 示例 2: 包含任意一个字符 ('a', 'e', 'i', 'o', 'u' - 元音字母)
if (preg_match("/[aeiou]/i", $text)) { // 字符类 `[]` 表示匹配其中任意一个字符
echo "'$text' 包含任意一个元音字母."; // 输出：包含
}
// 示例 3: 包含数字或特殊字符
$password = "MyP@ssw0rd!";
if (preg_match("/[0-9!@#$%^&*()_+]/", $password)) {
echo "密码 '$password' 包含数字或特殊字符."; // 输出：包含
}
?>

`preg_match()` 的灵活性使其成为处理“包含任意一个”场景的强大工具，尤其是当查找项数量较多或包含复杂的模式时。

2.2 场景二：判断是否包含“所有”指定字符/子串

这要求字符串中必须同时包含我们给定列表中的所有字符或子串。

2.2.1 方法一：循环遍历与布尔逻辑结合

同样，我们可以循环遍历待查找项，但这次需要确保所有项都被找到。只要有一个未找到，结果就是 `false`。<?php
$target_string = "PHP is a popular scripting language for web development.";
$required_keywords = ["PHP", "scripting", "web"];
$all_found = true;
foreach ($required_keywords as $keyword) {
if (!str_contains($target_string, $keyword)) { // PHP 8+
$all_found = false;
echo "'$target_string' 不包含必需关键字 '$keyword'.";
break; // 只要有一个没找到就退出
}
}
if ($all_found) {
echo "字符串包含所有指定关键字."; // 输出：包含
} else {
echo "字符串不包含所有指定关键字.";
}
?>

2.2.2 方法二：正则表达式（前瞻断言 `(?=...)`）

正则表达式提供了一种名为“前瞻断言”（lookahead assertion）的强大功能，可以在不消耗字符的情况下检查某个模式是否存在。这对于判断“所有”条件非常有用。<?php
$sentence = "Hello world! This is a test.";
// 要求同时包含 "Hello", "world", "test"
$pattern = "/(?=.*Hello)(?=.*world)(?=.*test)/s";
// s 修饰符让 '.' 匹配包括换行符在内的所有字符，确保能跨行查找（如果字符串有多行）
if (preg_match($pattern, $sentence)) {
echo "'$sentence' 同时包含 'Hello', 'world', 'test'."; // 输出：同时包含
} else {
echo "'$sentence' 不同时包含 'Hello', 'world', 'test'.";
}
$password_strong = "StrongP@ssw0rd!";
// 要求密码包含：至少一个大写字母、一个小写字母、一个数字、一个特殊字符
$strong_password_pattern = "/(?=.*[A-Z])(?=.*[a-z])(?=.*\d)(?=.*[!@#$%^&*()_+])(?=.{8,})/";
// (?=.{8,}) 要求总长度至少8个字符
if (preg_match($strong_password_pattern, $password_strong)) {
echo "密码 '$password_strong' 符合强度要求."; // 输出：符合
} else {
echo "密码 '$password_strong' 不符合强度要求.";
}
?>

前瞻断言虽然强大，但正则表达式本身会变得复杂且难以阅读和维护。对于简单的“所有”判断，循环遍历可能是更易懂的选择。

三、高级篇：更复杂的字符串包含判断与注意事项

3.1 正则表达式的深度应用

正则表达式远不止 `|` 和 `[]`。它能处理更精细的匹配需求：
特定位置包含： `^` 匹配字符串开头，`$` 匹配字符串结尾。例如 `/^start/` 匹配以 "start" 开头的字符串。
重复次数： `{n}`, `{n,}`, `{n,m}` (精确匹配n次，至少n次，n到m次), `*` (0次或多次), `+` (1次或多次), `?` (0次或1次)。
排除特定字符： `[^...]` 匹配不在字符类中的任何字符。例如 `/[^aeiou]/i` 匹配任何非元音字母的字符。
匹配特定类型字符： `\d` (数字), `\D` (非数字), `\s` (空白字符), `\S` (非空白字符), `\w` (字母、数字、下划线), `\W` (非字母、数字、下划线)。
修饰符：

`i`：不区分大小写匹配。
`s`：使 `.` 匹配包括换行符在内的所有字符。
`u`：启用 UTF-8 模式，正确处理多字节字符。
`m`：多行模式，使 `^` 和 `$` 匹配每行的开头和结尾，而不仅仅是整个字符串的开头和结尾。

<?php
$code_string = "function myFunction(param1, param2) { /* ... */ }";
// 包含以 "function" 开头，且包含括号的模式
if (preg_match("/^function\s+\w+$.*?$/", $code_string)) {
echo "'$code_string' 匹配函数定义模式.";
}
// 判断字符串是否只包含数字和字母
$alpha_numeric = "Abc123xyz";
if (preg_match("/^[a-zA-Z0-9]+$/", $alpha_numeric)) {
echo "'$alpha_numeric' 只包含字母和数字.";
}
?>

3.2 多字节字符（UTF-8）的考量

在处理包含中文、日文、韩文等非拉丁字符的字符串时，必须使用PHP的多字节字符串函数（`mb_*` 系列函数），以确保字符被正确识别和处理。标准的 `strpos()`、`strlen()` 等函数是基于字节而非字符进行操作的，可能导致错误结果。
`mb_strpos()` / `mb_stripos()`：多字节版本的 `strpos()`。
`mb_str_contains()`：PHP 8.0+ 的多字节版本 `str_contains()`。
`mb_strlen()`：获取多字节字符串的字符长度。
`mb_substr()`：截取多字节字符串。

<?php
$mb_string = "你好世界，Hello World！";
$mb_needle = "世界";
$mb_needle_case = "世界"; // 注意：中文查找通常不区分大小写
// 确保设置正确的内部编码，这很重要
mb_internal_encoding("UTF-8");
// mb_strpos()
if (mb_strpos($mb_string, $mb_needle) !== false) {
echo "'$mb_string' 包含 '$mb_needle' (mb_strpos)."; // 输出：包含
}
// mb_str_contains() (PHP 8+)
if (function_exists('mb_str_contains') && mb_str_contains($mb_string, $mb_needle_case)) {
echo "'$mb_string' 包含 '$mb_needle_case' (mb_str_contains)."; // 输出：包含
}
// 正则表达式使用 'u' 修饰符处理 UTF-8
if (preg_match("/你好(.*?)！/u", $mb_string)) {
echo "'$mb_string' 匹配包含中文的正则表达式."; // 输出：匹配
}
?>

对于多字节字符，正则表达式中使用 `u` 修饰符是强制性的，它会告诉PCRE（Perl Compatible Regular Expressions）引擎将字符串视为UTF-8序列。

3.3 性能与效率考量

`str_contains()` (PHP 8+)：对于简单的子串包含判断，它是最快、最简洁的选择。
`strpos()` / `stripos()`：对于PHP 7及更早版本，或需要获取位置信息时，它们是效率最高的。
`preg_match()`：正则表达式引擎有其自身的开销。对于非常简单的子串查找，它的性能通常不如 `strpos()`。但当需要复杂的模式匹配、任意一个或所有条件时，它提供了无与伦比的灵活性和表达力，且在处理复杂逻辑时可能比手动循环更高效。
循环遍历：当查找项较少时，循环结合 `str_contains()` 或 `strpos()` 是可读性好且性能不错的选择。但当查找项非常多时，每次循环都调用函数会增加开销，此时考虑构建一个更复杂的正则表达式可能更优。

选择最佳方法应基于具体需求、PHP版本和性能敏感度。一般原则是：能用简单函数解决就不用正则，能用 PHP 8+ 新函数就用新函数。

四、实际应用场景示例

字符串包含判断在实际开发中无处不在：
表单验证：

验证用户名是否包含非法字符。
验证密码强度（是否包含大小写字母、数字、特殊字符）。
验证邮箱格式是否包含 `@` 和 `.`。

内容过滤：

检测用户评论、帖子是否包含敏感词。
过滤HTML标签，防止XSS攻击。

URL路由：

根据URL路径是否包含特定关键词来匹配不同的控制器或操作。

文件处理：

检查日志文件行是否包含特定错误信息。
判断CSV文件行是否包含特定分隔符。

搜索引擎：

实现简单的文本搜索功能。

PHP提供了丰富且强大的函数来判断字符串是否包含特定字符或子串。从基础的 `strpos()`、`str_contains()`，到功能强大的 `preg_match()`，每种方法都有其适用场景和优缺点。
对于单个子串的简单查找，推荐使用 PHP 8+ 的 `str_contains()`，或 `strpos()`。
对于判断是否包含“任意一个”指定字符或子串，可以使用循环结合 `str_contains()`/`strpos()`，或利用 `preg_match()` 结合 `|` 运算符或字符类 `[]`。
对于判断是否包含“所有”指定字符或子串，循环遍历结合布尔判断是直观的方法，而正则表达式的“前瞻断言” (`(?=...)`) 则提供了更高级、紧凑的解决方案。
在处理多字节字符（如中文）时，务必使用 `mb_*` 系列函数，并在正则表达式中使用 `u` 修饰符。

作为专业的程序员，理解这些函数的原理、适用场景以及性能差异，能够帮助我们编写出更健壮、高效且易于维护的PHP代码。熟练掌握正则表达式，更是字符串处理能力的飞跃。```

2025-10-22

上一篇：PHP 连接远程数据库：安全高效的实现策略与最佳实践

下一篇：PHP 字符串操作：高效获取右侧字符的多种方法与实践