array_intersect_key()用于按键名比较数组并返回交集,常用于筛选允许字段、合并配置及清洗参数。1. 保留第一个数组中其他数组也存在的键名对应元素;2. 结合array_flip()实现白名单过滤表单数据;3. 与+操作符配合合并配置并限制合法键;4. 支持多数组求共同键名,如三个数组共有的键b和c被保留。

在 PHP 中,array_intersect_key() 是一个非常实用的函数,它根据键名(key)来比较多个数组,并返回交集部分。这个函数特别适合用于“保留指定键的数组”场景,比如从用户提交的数据中筛选出允许的字段,或合并配置项时只保留有效键。
array_intersect_key 基本用法
该函数会保留第一个数组中与其他数组拥有相同键名的元素,值保持不变,仅以键名为判断依据。
语法:
array array_intersect_key ( array $array1 , array $array2 [, array $... ] )
示例:
立即学习“PHP免费学习笔记(深入)”;
$data = ['name' => 'Alice', 'age' => 25, 'email' => 'alice@example.com', 'city' => 'Beijing'];$allowed = ['name' => 1, 'email' => 1, 'city' => 1]; // 键表示允许的字段
$filtered = array_intersect_key($data, $allowed);
print_r($filtered);
输出结果:
Array
(
[name] => Alice
[email] => alice@example.com
[city] => Beijing
)
可以看到,只有 name、email、city 这些在 $allowed 中出现的键被保留下来,age 被过滤掉了。
筛选表单数据:只保留允许的字段
在实际开发中,接收用户 POST 数据后,通常需要过滤掉非法或不期望的字段,防止恶意注入。这时可以用 array_intersect_key 快速实现白名单机制。
$post = $_POST; // 假设用户提交了 name, age, token, role 等字段$whitelist = array_flip(['name', 'email', 'phone']); // 将字段名转为键
$safe_data = array_intersect_key($post, $whitelist);
这里使用 array_flip() 把字段列表变成键名为允许字段的数组,再与原始数据取交集,即可完成安全筛选。
合并配置并保留指定结构
当你有默认配置和用户自定义配置时,可以使用 array_intersect_key 确保最终配置只包含预定义的键,避免意外参数干扰。
$default = ['host' => 'localhost',
'port' => 3306,
'username' => 'root',
'password' => '',
'charset' => 'utf8'
];
$custom = [
'host' => '192.168.1.100',
'username' => 'admin',
'extra' => 'ignored_value' // 不会被保留
];
$config = array_intersect_key($custom + $default, $default);
说明:
- $custom + $default:先合并,自定义值优先
- 再用 array_intersect_key(..., $default) 确保只保留合法键
- 即使 $custom 包含 extra 字段,也会被自动剔除
多数组键交集:找出共同配置项
如果有多个数组,想找出它们共有的键,也可以用此函数:
$arr1 = ['a' => 1, 'b' => 2, 'c' => 3];$arr2 = ['b' => 4, 'c' => 5, 'd' => 6];
$arr3 = ['c' => 7, 'a' => 8, 'b' => 9];
$common = array_intersect_key($arr1, $arr2, $arr3);
print_r($common);
输出:
Array
(
[b] => 2
[c] => 3
)
只有键 b 和 c 在三个数组中都存在,因此被保留。
基本上就这些。合理使用 array_intersect_key 可以让数组筛选更安全、简洁,尤其适合做字段过滤、配置合并、API 参数清洗等任务。关键是理解它“按 key 判断,保留值”的逻辑,配合 array_flip 或 + 操作符,能写出清晰高效的代码。











