如何在 PHP 中筛选出包含指定前缀子串的数组元素-php教程-PHP中文网

如何在 PHP 中筛选出包含指定前缀子串的数组元素

本文介绍使用 array_filter 结合 str_contains 高效识别并提取源数组中包含任意给定前缀字符串的键值对，适用于日志清洗、配置校验等需快速定位非法前缀内容的场景。

本文介绍使用 `array_filter` 结合 `str_contains` 高效识别并提取源数组中包含任意给定前缀字符串的键值对，适用于日志清洗、配置校验等需快速定位非法前缀内容的场景。

在实际开发中，我们常需验证一组文本数据是否意外混入了本应被排除的前缀（如 'prefix1'、'prefix2'），尤其当这些前缀并非严格位于字符串开头，而是作为子串出现在任意位置时。PHP 8.0+ 提供的 str_contains() 函数配合 array_filter() 可以简洁、高效地完成该任务。

以下是一个完整可运行的示例：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

<?php // 原始数据：可能混有非法前缀的文本数组（保留原始键）
$data = [
    100 => 'this is some text',
    161 => 'prefix1 : this is some text',
    224 => 'some other text',
    356 => 'prefix2 : some other text',
];

// 待检测的禁止前缀列表
$forbiddenPrefixes = ['prefix1', 'prefix2'];

// 筛选：返回所有包含任一禁止前缀的元素（保持原键）
$violations = array_filter($data, function ($text) use ($forbiddenPrefixes) {
    foreach ($forbiddenPrefixes as $prefix) {
        if (str_contains($text, $prefix)) {
            return true;
        }
    }
    return false;
});

print_r($violations);
// 输出：
// Array
// (
//     [161] => prefix1 : this is some text
//     [356] => prefix2 : some other text
// )
?>

✅ 关键要点说明：

array_filter() 默认保留回调函数返回 true 的项，并维持原始数组的键名，完美匹配需求；
str_contains($text, $prefix) 是 PHP 8.0+ 原生函数，语义清晰、性能优于 strpos($text, $prefix) !== false；
使用 use ($forbiddenPrefixes) 将外部变量引入匿名函数作用域，确保闭包正确访问；
若需严格匹配前缀（即仅开头出现），应改用 str_starts_with($text, $prefix) 替代 str_contains()；
对于 PHP

该方案简洁、可读性强，且无副作用——不修改原数组，适合嵌入数据校验流水线或自动化测试断言中。