在PHP开发中，经常遇到这样的需求：有一个数据数组，需要把其中某些已知的值剔除掉，只保留剩下的元素。相比于写循环逐个判断，使用内置的array_diff函数可以用一行代码完成集合级别的过滤，既直观又高效。
array_diff函数的基本用法
array_diff是PHP标准库提供的数组函数，用于计算数组的差集。它的第一个参数是待过滤的源数组，后续参数是一个或多个需要排除的值集合。函数会返回源数组里没有出现在任何其他参数数组中的值。
下面是一段最基础的示例代码，演示如何从用户角色数组中去除管理员和游客两种特定值：
<?php
$roles = array('admin', 'editor', 'guest', 'subscriber', 'editor');
$exclude = array('admin', 'guest');
$result = array_diff($roles, $exclude);
print_r($result);
// 输出: Array ( [1] => editor [3] => subscriber [4] => editor )
?>
从输出可以看出，array_diff只关心值是否相等，不关心键名。源数组中索引为1、3、4的元素因为值不在排除列表中而被保留，但键名保持原样，所以结果数组的键是不连续的。
如果希望结果是一个从0开始连续编号的数组，可以配合array_values使用，这样在后续使用for循环或者json_encode时更加友好。
<?php $clean = array_values($result); print_r($clean); // 输出: Array ( [0] => editor [1] => subscriber [2] => editor ) ?>
底层原理与性能特点
array_diff在实现上会将除第一个数组之外的所有参数数组的值放入哈希表，然后遍历源数组，对每个值做哈希查找。因为哈希查找的平均复杂度是O(1)，所以整体时间复杂度接近O(n)，其中n是源数组的长度。这比在foreach里用in_array逐个线性搜索（复杂度O(n*m)）要快得多，尤其是当排除值较多或源数组很大时。
需要注意的是，array_diff进行的是宽松比较（==），也就是标量和字符串之间会发生类型转换。例如数字1和字符串'1'会被认为是相等的值。如果业务要求严格区分类型，应该使用array_diff_strict函数，它使用全等比较（===）来匹配。
<?php
$source = array(1, 2, '1', '3');
$remove = array('1');
// 宽松比较，数字1和字符串'1'都将被去除
var_dump(array_diff($source, $remove));
// 严格比较，仅去除字符串'1'
var_dump(array_diff_strict($source, $remove));
?>
上面的例子清晰展示了两种函数在类型处理上的差异。在金额、ID等场景中，类型错误可能导致严重bug，因此要按需选择。
多数组批量排除与常见误区
array_diff支持传入多个排除数组，它们会被合并视为同一个排除集合。比如既要剔除系统保留词，又要剔除本次黑名单词，可以分开写两个数组传进去，而不需要手动合并。
<?php
$tags = array('php', 'mysql', 'test', 'demo', 'sql');
$system = array('test', 'demo');
$blacklist = array('sql');
$safe = array_diff($tags, $system, $blacklist);
print_r($safe);
// 输出: Array ( [0] => php [1] => mysql )
?>
一个常见误区是认为array_diff会重新索引或者改变原数组。实际上原函数不会修改传入的数组，且返回的数组保留原键名。另一个误区是用它来按键名过滤，这是不对的，按键名差集应使用array_diff_key，按键值对同时匹配应使用array_diff_assoc。
在二维数组场景下，array_diff只能比较一维值，如果数组元素是子数组，需要先用array_map把子数组序列化成字符串，或者自己写回调配合array_filter处理。盲目对二维数组用array_diff会得到意外空白结果，因为子数组之间永远不全等。
与array_filter的写法对比
除了array_diff，很多开发者习惯用array_filter加匿名函数来做排除。两者各有适用面：array_filter更灵活，可以写复杂条件；array_diff更简洁，适合纯值排除且性能更好。
| 对比项 | array_diff | array_filter |
|---|---|---|
| 代码简洁度 | 高，一行完成 | 中，需写回调 |
| 类型比较 | 默认宽松，有strict版 | 由回调逻辑决定 |
| 键名处理 | 保留原键 | 保留原键 |
| 复杂条件 | 不支持 | 支持 |
如果仅仅是去除固定几个值，优先使用array_diff，可读性和运行效率都更优。当过滤规则涉及范围判断、对象属性提取时，再考虑array_filter。
举例来说，要排除所有小于10的数字，array_diff无能为力，而array_filter轻松实现：
<?php
$nums = array(3, 8, 15, 22, 9);
$big = array_filter($nums, function($v) {
return $v >= 10;
});
print_r(array_values($big));
// 输出: Array ( [0] => 15 [1] => 22 )
?>
实际业务中的组合技巧
在接口返回前清洗数据，经常需要去除空字符串、null以及特定占位符。可以先用array_filter去空，再用array_diff去特定值，形成管道式处理。
<?php
$list = array('a', '', 'none', null, 'b', 'none');
$step1 = array_filter($list, function($v) {
return $v !== null && $v !== '';
});
$step2 = array_diff($step1, array('none'));
$final = array_values($step2);
print_r($final);
// 输出: Array ( [0] => a [1] => b )
?>
这种写法把不同职责分开，比在单个循环里写一大堆if更易于维护。同时因为两步都是PHP内置函数，执行效率也有保障。
总结来看，array_diff是PHP中处理一维数组特定值过滤的最直接工具。理解它的比较规则、键名保留特性以及和array_filter的分工，能让你在写数据清洗逻辑时更加从容，也能避免不必要的手写循环带来的性能与正确性问题。
PHParray_diff数组过滤修改时间：2026-08-07 01:57:34