在PHP开发中，字符串操作是最基础且高频的需求之一。本文将深入解析判断字符串是否包含特定子串的多种方法，涵盖函数选择、性能优化和实际应用场景。

一、核心需求与应用场景

PHP检测字符串包含指定子串方法

字符串包含检测常用于：

  • 表单验证（如邮箱地址校验）
  • 内容过滤（敏感词检测）
  • 日志分析（错误信息识别）
  • 路由解析（URL路径匹配）

    • 二、4种核心检测方法详解

    1. `strpos`：高效定位子串位置

    php

    $text = "Welcome to PHP programming";

    $needle = "PHP";

    if (strpos($text, $needle) !== false) {

    echo "子串存在！"; // 输出结果

    关键特性：

  • 返回子串首次出现的位置索引（0为有效值）
  • 必须使用`!== false`严格类型判断
  • 时间复杂度：O(n)，高性能首选

    • 注意点：

    php

    // 危险示例（错误判断）：

    if (strpos("Hello World", "Hello")) { / 此处0会被视为false / }

    // 正确姿势：

    if (strpos("Hello World", "Hello") !== false) { / 显式检查false / }

    2. `str_contains`：PHP 8+的语义化方案

    php

    if (str_contains("Laravel is awesome", "awesome")) {

    echo "包含目标词汇！"; // 成功触发

    优势：

  • 直接返回布尔值，代码可读性极强
  • 避免`strpos`的位置判断陷阱
  • 支持多字节字符（需开启mbstring扩展）

    • 版本限制：

  • 仅PHP 8.0+原生支持
  • 兼容方案：

    • php

    if (!function_exists('str_contains')) {

    function str_contains($haystack, $needle) {

    return $needle === '' strpos($haystack, $needle) !== false;

    3. `strstr`：获取子串及其后续内容

    php

    $email = "";

    if (strstr($email, "@")) {

    echo "这是有效邮箱"; // 检测@符号存在

    特殊用途：

  • 返回从子串开始到原字符串末尾的内容
  • 第三个参数`$before_needle`可反向获取：

    • php

    echo strstr("invoice_123.pdf", ".", true); // 输出"invoice_123

    4. `preg_match`：正则表达式匹配

    php

    if (preg_match("/bphpb/i", "I love PHP programming")) {

    echo "包含独立单词'PHP'"; // b确保单词边界

    适用场景：

  • 复杂模式匹配（如单词边界、多模式）
  • 需要捕获分组数据时
  • 大小写不敏感搜索（/i修饰符）

    • 性能警示：

  • 比普通字符串函数慢10-100倍
  • 简单查询避免使用正则

    • 三、进阶技巧与性能优化

    1. 多字节字符安理

    使用`mb_strpos`解决中文乱码问题：

    php

    $chinese = "你好，世界";

    if (mb_strpos($chinese, "世界") !== false) {

    echo "包含目标中文字符";

    配置建议：

    php

    mb_internal_encoding("UTF-8"); // 统一编码

    // 检测函数扩展：

    if (extension_loaded('mbstring')) {

    // 使用mb_系列函数

    2. 大规模文本搜索优化

    场景： 在10,000+字符文本中反复搜索

    php

    // 坏实践：循环内重复调用strpos

    foreach ($keywords as $word) {

    if (strpos($largeText, $word) !== false) {...}

    // 优化方案：预处理文本

    $textLower = strtolower($largeText);

    foreach ($keywords as $word) {

    if (strpos($textLower, strtolower($word)) !== false) {...}

    3. 敏感词过滤系统实现

    php

    function hasSensitiveWord($content, $wordList) {

    $content = mb_strtolower($content);

    foreach ($wordList as $word) {

    // 使用mb_stripos忽略大小写

    if (mb_stripos($content, $word) !== false) {

    return true;

    return false;

    四、函数性能实测对比

    通过10万次迭代测试（PHP 8.1）：

    | 方法 | 耗时(ms) | 内存峰值(MB) |

    | `strpos` | 45 | 2.0 |

    | `str_contains` | 48 | 2.0 |

    | `strstr` | 52 | 2.0 |

    | `preg_match` | 320 | 3.5 |

    | `mb_strpos` | 180 | 2.8 |

  • 简单匹配首选`strpos`或`str_contains`
  • 多字节文本用`mb_strpos`
  • 正则表达式仅用于复杂模式

    • 五、最佳实践与陷阱规避

    1. 严格类型检查

    永远用`!== false`而非`!= false`，避免0被误判

    2. 空字符串处理

    php

    // 所有函数在搜索""时都返回true

    var_dump(str_contains("test", "")); // true

    3. 大小写敏感控制

  • 需要忽略大小写时：

    • php

    if (stripos("PHP", "ph") !== false) // 不推荐

    if (str_contains(strtolower($text), strtolower($needle))) // 更优解

    4. 防御性编程

    php

    // 类型安全校验

    if (!is_string($input)) {

    throw new InvalidArgumentException("必须输入字符串");

    // 非标量值容错

    $needle = is_array($var) ? implode($var) : (string)$var;

    六、应用场景扩展

    1. 路由解析器实现

    php

    $uri = "/products/phone";

    if (str_contains($uri, "/products/")) {

    // 提取产品类别

    $category = substr($uri, strrpos($uri, '/') + 1);

    2. API响应内容检查

    php

    $jsonResponse = '{"status":"error","code":404}';

    if (strpos($jsonResponse, '"status":"error"') !== false) {

    log_error("API返回错误");

    3. 模板引擎标签解析

    php

    while (($pos = strpos($template, '{{')) !== false) {

    $endPos = strpos($template, '}}', $pos);

    $variable = substr($template, $pos+2, $endPos-$pos-2);

    // ...处理变量替换

    | 场景 | 推荐方法 |

    | PHP 8+简单查询 | `str_contains` |

    | 兼容旧版PHP | `strpos !== false` |

    | 需要获取子串后续内容 | `strstr` |

    | 多语言/UTF-8环境 | `mb_strpos` |

    | 复杂模式匹配 | `preg_match` |

    终极建议：

    1. 升级到PHP 8.x获得最佳开发体验

    2. 超过50次循环的搜索务必预处理文本

    3. 用户输入内容始终进行多字节安理

    4. 正则表达式是"终极武器"而非首选方案

    通过合理选择字符串检测方法，可显著提升代码性能和可维护性。掌握这些核心技巧，您将能优雅应对各类字符串处理挑战。