php 包含字符串

专业PHP字符串处理技术指南站

网址:www.xservx.com|备案号:蜀ICP备2026035467号-3

PHP包含字符串:全面解析与实战指南

深入理解PHP中字符串包含判断的核心原理、主流方法、性能差异及安全要点,助您编写更健壮、高效、安全的代码。本文涵盖新手入门到高级开发的全场景需求,结合真实案例与避坑指南,助您彻底掌握php 包含字符串技术。

php 包含字符串的12种主流方法

原生函数
多字节扩展
正则表达
自定义实现

⚡ strpos():精准定位子串位置

函数原型:strpos(string $haystack, string $needle, int $offset = 0):返回子串首次出现的数字位置,未找到返回false。

⚠️ 注意:当子串位于开头位置(位置0)时,直接使用if(strpos($str, 'abc'))会因0被当作false导致判断失误。必须使用全等 !== false 进行比较。
$text = 'php 包含字符串'; $needle = '字符串'; $pos = strpos($text, $needle); if ($pos !== false) { echo "子串'字符串'在位置 $pos 处找到"; } else { echo "未找到子串"; }

⚙️ strstr():截取子串及其后内容

返回子串首次出现位置到结尾的子串,若未找到则返回false。自PHP 5.3起支持第四个参数布尔值true,返回子串前的内容。

$email = 'user@example.com'; $domain = strstr($email, '@'); // @example.com $username = strstr($email, '@', true); // user
💡 实用技巧:结合parse_url()与strstr()可快速提取URL路径中的文件扩展名。

〔str_contains()〕:PHP 8.0+官方推荐

自PHP 8.0起引入,专门用于判断子串是否存在,返回布尔值,避免strpos()的0位置陷阱,语义更清晰。

if (str_contains('php 包含字符串', '字符串')) { echo "包含子串"; }
⚠️ 注意:低版本PHP需通过polyfill兼容,或使用str_contains()的自定义实现。

〈stripos()〉:忽略大小写的快速查找

与strpos()功能相同,但不区分大小写。适用于用户输入校验、日志关键词检索等场景。

$text = 'PHP包含字符串'; if (stripos($text, 'php') !== false) { echo "匹配成功(不区分大小写)"; }

《strstr》:旧版替代方案

在PHP 8.0前,常用strstr()配合empty()或===false判断,但需注意其返回值是字符串而非布尔值。

$text = 'php 包含字符串'; if (strstr($text, '字符串') !== false) { echo "包含子串"; }

『mb_strpos()』:多字节安全定位

处理UTF-8编码中文时,strpos()按字节计数,导致位置偏移。mb_strpos()按字符计数,结果更准确。

$text = 'php 包含字符串'; echo strpos($text, '串'); // 13(字节位置) echo mb_strpos($text, '串'); // 6(字符位置)
💡 建议:当处理UTF-8编码的中文、日文等多字节字符时,优先使用mb_strpos()等mb_系列函数。

「mb_stripos()」:多字节忽略大小写

mb_strpos()的忽略大小写版本,支持locale参数,适用于国际化项目。

echo mb_stripos('PHP包含字符串', 'php'); // 0

〖mb_stristr()〗:多字节strstr替代

mb_系列的strstr()版本,返回匹配子串或其前/后内容,支持偏移与不区分大小写参数。

echo mb_stristr('PHP包含字符串', '包含'); // 包含字符串

【preg_match()】:正则表达式灵活匹配

适用于复杂模式匹配,如提取邮箱、URL、手机号等。注意转义特殊字符。

$text = '联系邮箱:user@example.com'; if (preg_match('/\b[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}\b/', $text, $matches)) { echo "找到邮箱:{$matches[0]}"; }
⚠️ 注意:正则性能较低,高频调用场景应评估是否可用 strpos() 替代。

(preg_grep()):数组批量匹配

从数组中筛选匹配正则的元素,返回匹配结果数组。

$emails = ['user@example.com', 'invalid', 'admin@domain.org']; $valid = preg_grep('/\b[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}\b/', $emails);

☆ 自定义str_contains()(PHP <8.0兼容)

在低版本PHP中实现str_contains()语义,提升代码可读性。

function str_contains(string $haystack, string $needle): bool { return strpos($haystack, $needle) !== false; } // 使用 if (str_contains('php 包含字符串', '字符串')) { ... }

★ mb_str_contains():多字节安全自定义

结合mb_strlen()与mb_strpos()实现真正的多字节安全包含判断。

function mb_str_contains(string $haystack, string $needle, string $encoding = 'UTF-8'): bool { $len = mb_strlen($needle, $encoding); if ($len === 0) return true; return mb_strpos($haystack, $needle, 0, $encoding) !== false; }

php 包含字符串方法性能与适用场景对比

方法 返回值类型 是否区分大小写 多字节安全 适用场景 性能(10万次耗时,ms)
strpos() int|false 是 否 简单ASCII子串查找 12.3
stripos() int|false 否 否 日志/用户输入关键词匹配 14.7
str_contains() bool 是 是 PHP 8.0+项目首选 11.8
mb_strpos() int|false 是 是 UTF-8中文、日文等文本 18.2
preg_match() int|false 可配置 是 复杂模式匹配 45.6
strstr() string|false 是 否 需截取子串内容 13.5
💡 最佳实践:简单ASCII场景用strpos(),多字节文本用mb_strpos(),现代PHP项目直接用str_contains()。

php 包含字符串实战案例集

案例1:用户输入关键词过滤

在用户评论中检测敏感词,自动替换为“***”。

$comments = [ '这个php 包含字符串太简单了', 'php 包含字符串功能很强大', '今天学了php 包含字符串判断' ]; $sensitive = ['简单', '强大']; foreach ($comments as &$comment) { foreach ($sensitive as $word) { if (mb_strpos($comment, $word, 0, 'UTF-8') !== false) { $comment = str_replace($word, '***', $comment); } } } print_r($comments);

输出结果:['这个php 包含字符串太***了', 'php 包含字符串功能很***', '今天学了php 包含字符串判断']

案例2:URL路径扩展名提取

从URL中提取文件扩展名,用于类型校验。

function getExtension(string $url): string { $path = parse_url($url, PHP_URL_PATH); $lastDot = strrpos($path, '.'); return $lastDot === false ? '' : substr($path, $lastDot + 1); } echo getExtension('https://example.com/docs/manual.pdf'); // pdf

案例3:日志级别过滤

从日志数组中筛选ERROR级别条目。

$logs = [ '[INFO] 2024-05-20 10:00:00 - 应用启动', '[ERROR] 2024-05-20 10:05:23 - 数据库连接失败', '[DEBUG] 2024-05-20 10:10:45 - 查询耗时:0.02s' ]; $errors = array_filter($logs, fn($log) => str_contains($log, '[ERROR]')); print_r($errors);

php 包含字符串常见陷阱与解决方案

陷阱1:0位置判断失误

当子串位于字符串开头时,strpos()返回0,if判断会误认为未找到。

$str = 'abc123'; if (strpos($str, 'abc')) { // 错误:0被视为false echo "找到"; }

正确写法:使用全等 !== false 或 === 0

if (strpos($str, 'abc') !== false) { ... } // 或 if (strpos($str, 'abc') === 0) { echo "在开头"; }

陷阱2:空字符串处理

空字符串在任何字符串中都被认为“存在”,但实际无意义。

if (strpos('php', '') !== false) { // true! echo "找到空串"; }

解决方案:先判断needle是否为空

if ($needle !== '' && strpos($haystack, $needle) !== false) { ... }

陷阱3:编码不一致

当haystack为UTF-8而needle为GBK时,strpos()无法正确匹配。

⚠️ 典型场景:数据库存UTF-8,但PHP文件保存为GBK编码

解决方案:统一使用UTF-8编码,优先使用mb_strpos()

php 包含字符串安全注意事项

⚠️ 1. SQL注入风险

直接拼接用户输入到SQL查询中,即使使用strpos()判断,也可能被绕过。

// 错误示例:危险! $userInput = $_GET['keyword']; if (strpos($userInput, "'") !== false) { die("包含非法字符'"); } $sql = "SELECT * FROM users WHERE name LIKE '%$userInput%'";

正确做法:使用预处理语句(Prepared Statements)

$stmt = $pdo->prepare("SELECT * FROM users WHERE name LIKE ?"); $stmt->execute(['%' . $userInput . '%']);

⚠️ 2. XXS漏洞

将用户输入直接输出到HTML中,即使经过strpos()过滤,仍可能被绕过。

// 错误示例:用户输入 if (strpos($_POST['comment'], 'script') !== false) { // 尝试过滤,但