本文介绍使用 array_filter 结合 str_contains 高效识别并提取源数组中包含任意给定前缀字符串的键值对，适用于日志清洗、配置校验等需快速定位非法前缀内容的场景。
本文介绍使用 `array_filter` 结合 `str_contains` 高效识别并提取源数组中包含任意给定前缀字符串的键值对，适用于日志清洗、配置校验等需快速定位非法前缀内容的场景。
在实际开发中，我们常需验证一组文本数据是否意外混入了本应被排除的前缀（如 'prefix1'、'prefix2'），尤其当这些前缀并非严格位于字符串开头，而是作为子串出现在任意位置时。PHP 8.0+ 提供的 str_contains() 函数配合 array_filter() 可以简洁、高效地完成该任务。
以下是一个完整可运行的示例：
<?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 < 8.0 环境，可定义兼容性函数或使用 mb_strpos($text, $prefix, 0, 'UTF-8') === 0 实现前缀判断。
该方案简洁、可读性强，且无副作用——不修改原数组，适合嵌入数据校验流水线或自动化测试断言中。
立即学习“PHP免费学习笔记（深入）”；
