PHP array_find 怎样查找第一个满足条件的数组元素

如果只需要从数组中找出第一个满足条件的元素，PHP 8.5 提供的 array_find() 比手写循环更直接。它按数组顺序调用回调，回调第一次返回 true 时立即返回对应的元素值；一个都找不到时，则返回第三个参数指定的默认值。

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

一、最小用法：找到第一个大于 100 的订单金额

array_find() 的第一个参数是待搜索数组，第二个参数是回调。回调接收元素值和键，返回布尔值表示当前元素是否命中。

 100;
    }
);

var_dump($firstLargeAmount); // int(120)
?>

结果是 120，而不是所有大于 100 的金额。因为函数在第一个命中后就结束了，适合“首个匹配项”这种明确需求。

二、回调参数与短路顺序

回调的第一个参数是元素值，第二个参数是元素键。对关联数组来说，键参数尤其有用；对索引数组来说，它通常是从 0 开始的整数。函数沿着数组当前的迭代顺序检查元素，不会替你重新排序。

 ['enabled' => false],
    'billing' => ['enabled' => true],
    'report' => ['enabled' => true],
];

$service = array_find(
    $services,
    static function (array $config, string $name): bool {
        // 键名参与判断，值结构负责表达服务是否启用。
        return $name !== 'search' && $config['enabled'] === true;
    }
);

var_dump($service); // array('enabled' => true)
?>

这里返回的是 billing 对应的配置值，而不是键名。如果需要键名，应改用 array_find_key()，不要依赖再次遍历数组来反推键。

三、没有匹配项时使用默认值

第三个参数用于定义“没有匹配项”的返回值。建议在业务层使用一个调用方容易识别的默认值，避免把空字符串、0 或 false 误认为成功查到的元素。

 '同步日志', 'priority' => 'normal'],
    ['name' => '清理缓存', 'priority' => 'low'],
];

$notFound = ['name' => '没有高优先级任务', 'priority' => 'none'];
$task = array_find(
    $tasks,
    static function (array $task): bool {
        // 只把明确的 high 任务视为命中。
        return ($task['priority'] ?? null) === 'high';
    },
    $notFound
);

var_dump($task === $notFound); // bool(true)
?>

默认值也会按原样返回。若默认值是数组或对象，可以直接作为业务分支的哨兵；若默认值是标量，则应确认它不会与合法元素值混淆。

四、匹配值为 null 时怎样判断

默认情况下，没找到结果返回 null。但数组中可能确实存在一个满足条件、且值就是 null 的元素，此时直接用 $result === null 无法区分两种情况。

可以传入一个不会出现在业务数组中的对象作为哨兵。对象比较使用严格比较，就能区分“返回了 null”与“返回了哨兵”。

 '已脱敏', 'value' => null],
    ['name' => '普通值', 'value' => 'ok'],
];
$missing = new stdClass();

$result = array_find(
    $records,
    static function (array $record): bool {
        // 只按名称寻找目标记录，允许目标记录的 value 为 null。
        return $record['name'] === '已脱敏';
    },
    $missing
);

if ($result === $missing) {
    echo '没有找到记录';
} elseif ($result['value'] === null) {
    echo '找到了记录，但值确实是 null';
} else {
    echo '找到了非 null 值';
}
?>

五、常见误区与选择建议

还要注意回调中的类型假设：数组数据来自外部输入时，先用 isset()、空合并运算符或显式类型判断保护字段访问。回调抛出的异常也会直接中断查找，不应把异常当成“没有匹配项”。

总结

array_find() 解决的是“按当前顺序返回第一个满足条件的值”。记住三点即可：回调返回 true 就停止；第三参数负责定义未命中的结果；合法值可能为 null 时，用对象哨兵区分未找到。需要键、最后一个值或全部结果时，选择对应函数，不要让调用者猜测返回值含义。

相关问题

array_find 找不到元素时默认返回什么？

默认返回 null，也可以通过第三个参数传入自定义默认值。

array_find 会返回数组键吗？

不会，它返回满足条件的元素值。需要键时使用 array_find_key()。