PHP array_intersect_key 怎样按键保留配置字段

在接口接收配置、表单字段或白名单参数时，常见需求不是修改值，而是只留下允许出现的键。PHP 的 array_intersect_key() 正好适合这个任务：它以第一个数组为结果来源，只保留那些在后续数组中都能找到的键，返回值仍来自第一个数组。

官方地址：https://www.php.net/manual/en/function.array-intersect-key.php

要按字段名裁剪配置，先把字段名列表变成“键集合”，再调用 array_intersect_key($config, $allowedKeys)。不要把白名单数组直接当成第二个参数，也不要误用只比较值的 array_intersect()。

最小写法：用键白名单裁剪配置数组

假设原配置包含展示、分页和内部字段，页面只允许使用 title、page_size 两个键。字段名列表本身是普通的索引数组，不能直接提供这两个键，因此先用 array_flip() 把列表值翻到键的位置。

 'PHP 入门',
    'page_size' => 20,
    'debug' => true,
];

// 字段列表转换成 ['title' => 0, 'page_size' => 1] 这样的键集合。
$allowedFields = ['title', 'page_size'];
$allowedKeys = array_flip($allowedFields);

// 结果保留 $config 中的原值和源数组顺序。
$publicConfig = array_intersect_key($config, $allowedKeys);
print_r($publicConfig);

结果中会留下 title 和 page_size，debug 被排除。第二个数组里的 0、1 并不会覆盖源值；它们只是占位值，真正返回的值来自第一个参数。

按键筛选和按值筛选不是一回事

选函数时先问“我要比较什么”。array_intersect_key() 只比较键，适合字段白名单；array_intersect() 比较值，适合判断一组值的交集；如果键和值都必须匹配，才考虑 array_intersect_assoc()。

 'safe', 'retry' => 3];
$candidate = ['mode' => 'fast', 'retry' => 3];

// 只看键：mode 和 retry 都会保留 source 的值。
$byKey = array_intersect_key($source, $candidate);

// 只看值：只有值 3 能在 candidate 中找到。
$byValue = array_intersect($source, $candidate);

// 同时看键和值：mode 的值不同，因此不会匹配。
$byKeyAndValue = array_intersect_assoc($source, $candidate);

这里最容易误解的是“第二个数组决定输出值”。实际上，按键交集返回的仍是 $source 的键值对；第二个数组只是说明哪些键被允许进入结果。

工程约束：键类型、顺序和空结果

PHP 官方手册说明，键的比较按字符串形式严格比较。实际使用中，白名单最好统一使用和源数组一致的字符串字段名，不要把数字索引、数字字符串和业务字段名混在一起，否则读代码的人很难判断匹配边界。

返回结果沿用第一个数组的键和值以及遍历顺序。如果后续接口还要求固定展示顺序，应先按目标顺序组织源数组，或在筛选后单独重排；不要期待第二个白名单数组自动改变顺序。

白名单为空时，array_flip([]) 得到空数组，交集结果也为空。如果业务上“没有配置白名单”意味着拒绝所有字段，这个行为是合适的；如果意味着使用默认字段，应在调用前显式补上默认列表。

速查：配置裁剪的落地清单

• 第一个参数放要保留值的源数组。
• 字段名列表先用 array_flip() 变成键集合。
• 按键筛选用 array_intersect_key()，不要用按值交集替代。
• 需要键和值同时相等时，再使用 array_intersect_assoc()。
• 确认空白名单、数字键和结果顺序是否符合业务约定。

相关问题

array_intersect_key 会修改原数组吗？不会，它返回新的数组，原数组仍可继续使用。

为什么结果里的值不是白名单数组的值？因为该函数以第一个数组为结果来源，后续数组只参与键匹配。

需要递归保留嵌套配置怎么办？当前函数只处理当前层键；嵌套结构应为每一层明确白名单，或另行设计递归裁剪函数。