PHP array_find 怎么同时取得命中的键和值

想让 array_find() 同时给出命中的键和值，最稳妥的写法不是继续从返回值里“猜键”，而是先用同一个回调调用 array_find_key() 取得键，再用这个键回查原数组。这样既保留了键值对，也能区分“没有命中”和“命中的值刚好是 null”。这两个函数从 PHP 8.4.0 才可用。

先分清 array_find 返回值的边界

array_find() 的回调签名包含两个参数：先是元素值，再是数组键；但函数结果只有元素值。它找到第一个回调返回 true 的元素后就停止继续遍历，没有符合项时返回 null。

问题在于数组本身也可能有一个满足条件且值为 null 的元素。此时函数返回的 null 与“一个都没找到”完全相同。因此，业务代码若还需要键，最好不要先用 array_find() 再尝试反向搜索。

用 array_find_key 建立键值对

array_find_key() 的回调参数和停止规则与 array_find() 一致，但返回的是命中键。键不会是 null，所以可以把 null 作为未命中的明确标记：

 ['status' => 'done', 'amount' => 0],
    'A-101' => ['status' => 'pending', 'amount' => null],
    'A-102' => ['status' => 'pending', 'amount' => 88],
];

$key = array_find_key(
    $orders,
    function (array $order): bool {
        // 只按状态筛选；金额为 null 仍然是合法命中值。
        return $order['status'] === 'pending';
    }
);

if ($key !== null) {
    // 键和值来自同一个原数组元素，避免再次按值猜测位置。
    $value = $orders[$key];
    var_dump($key, $value);
} else {
    // null 只表示没有符合条件的键。
    echo '没有待处理订单';
}
?>

在这个例子里，结果是键 A-101 和对应数组。即便把命中元素改成标量 null，判断仍然看键，而不是看 $value、empty() 或布尔转换。

把判断和取值写成可复用的小模式

如果项目多次需要这个结果，可以把“键存在性”和“值读取”保持在同一个局部范围内。键为整数 0 时也必须使用严格的 !== null，不能写成 if ($key)，因为 0 是有效数组键但会被当成假值。

 $key, 'value' => $items[$key]];
}

$pair = firstPair(
    [0 => null, 1 => 'ready'],
    function (?string $value): bool {
        // null 也可以按业务规则成为命中对象。
        return $value === null;
    }
);

var_dump($pair['key'], $pair['value']); // 0, NULL
?>

这个封装的返回值有两层含义：外层 null 表示没有命中；只要返回数组，即使其中的 value 是 null 也仍然表示命中。若项目需要保留引用语义、同时匹配多个元素或处理异常回调，则应改用显式 foreach，不要把这个小模式扩展成复杂查询器。

旧版本与重复命中的取舍

PHP 8.3 及更早版本没有这两个函数，兼容写法就是遍历数组并在第一次满足条件时立即返回键和值：

 $value) {
    if ($matches($value, $key)) {
        $pair = ['key' => $key, 'value' => $value];
        break;
    }
}

// 用 array_key_exists 区分“未设置结果”和合法的 null 值。
if (isset($pair)) {
    var_dump($pair);
}
?>

无论使用新函数还是 foreach，都应先确定“第一个命中”是否符合业务排序。数组的遍历顺序决定结果，函数不会替你按金额、时间或键名排序；需要不同优先级时，应先构造明确顺序的数据，再执行查找。

相关问题

array_find 能直接返回键和值组成的数组吗？

不能。它的返回类型是命中的值；需要键时使用 array_find_key()，然后回查原数组。

命中值为 null 时怎么判断成功？

不要判断值，改判断 array_find_key() 的结果是否严格不等于 null。

array_find_key 会返回所有匹配键吗？

不会。它只返回第一个满足回调的键；要收集全部结果，应使用 array_filter() 或显式遍历。