array_diff 是 PHP 中用于计算数组差集的内置函数，它比较第一个数组与其他数组的值（非键名），返回第一个数组中存在但其他数组中都不存在的元素组成的数组。结果保留原始键名，不重排索引。

基本用法与参数规则

函数签名：array_diff(array $array1, array ...$arrays): array

• $array1 是基准数组，所有结果均从中提取
• ...$arrays 可传入任意多个对比数组（至少一个）
• 比较基于值相等（松散比较，如 0 == "0"、false == ""），不依赖键名或数据类型
• 返回数组保持 $array1 的原始键名，不会自动重置为数字索引

常见使用场景示例

例如过滤掉黑名单用户 ID：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

$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 配合 === 逻辑）
• 大数组性能较低，因内部是嵌套遍历；超万级数据建议改用数据库或集合操作优化