array_diff 是 PHP 中用于计算数组差集的内置函数，它比较第一个数组与其他数组的值（非键名），返回第一个数组中存在但其他数组中都不存在的元素组成的数组。结果保留原始键名，不重排索引。
基本用法与参数规则
函数签名：array_diff(array $array1, array ...$arrays): array
- $array1 是基准数组，所有结果均从中提取
- ...$arrays 可传入任意多个对比数组（至少一个）
- 比较基于值相等（松散比较，如
0 == "0"、false == ""），不依赖键名或数据类型 - 返回数组保持
$array1的原始键名，不会自动重置为数字索引
常见使用场景示例
例如过滤掉黑名单用户 ID：
TWE-Commerce
下载
一个功能强大的B2B与B2C的购物平台，除了原本OSC功能外，增加更新的功能： 一、 取消了register_globals必须开启的限制 二、 將HTML程式碼与PHP程式碼完全分离，採用了smarty 樣板引擎 三、 每支档案includes所需函数与资料库连结，使的网页显示速度明显提升 四、 检视、购买商品群组权限设定 五、 十八岁以下禁购机制 六、 折价券购物抵扣机制 七、 礼券购物机制
$allUsers = [101 => 'Alice', 102 => 'Bob', 103 => 'Charlie', 104 => 'David']; $bannedIds = [102, 104]; $result = array_diff($allUsers, $bannedIds); // ❌ 错误：类型不匹配，无法直接比字符串和整数
正确做法是确保值类型一致：
立即学习“PHP免费学习笔记（深入）”；
$allNames = ['Alice', 'Bob', 'Charlie', 'David']; $bannedNames = ['Bob', 'David']; $result = array_diff($allNames, $bannedNames); // 返回 ['Alice', 'Charlie']，键名保持 0 和 2
与其他差集函数的区别
- array_diff_assoc()：同时比较键名和值，键名不同即视为差异
- array_diff_key()：仅按键名对比，忽略值内容
- array_diff_uassoc() 和 array_diff_ukey()：支持自定义比较函数，适用于复杂键/值逻辑
- 所有
array_diff*系列函数都不修改原数组，返回新数组
注意事项与避坑提示
- 空数组作为对比参数时，结果等于
$array1（无任何元素被过滤） - 若
$array1为空，结果恒为空数组 - 数值与字符串在松散比较下可能意外匹配（如
0、""、false互等），需预处理或改用严格比较函数（如array_udiff配合===逻辑） - 大数组性能较低，因内部是嵌套遍历；超万级数据建议改用数据库或集合操作优化
