array_find() / array_find_key() (PHP 8.4)

Also Known As

TL;DR

Explanation

Finding the first matching element in an array was always awkward in PHP — either a foreach with a break, or array_filter() which returns all matches followed by reset() or current() to grab the first. PHP 8.4 adds four related functions: array_find() returns the first value where the callback returns true, array_find_key() returns its key, array_any() returns true if any element matches, and array_all() returns true if all elements match. These mirror JavaScript's Array.find(), Array.findIndex(), Array.some(), and Array.every(). All four short-circuit — they stop iterating as soon as the result is determined.

Common Misconception

Why It Matters

Common Mistakes

• Expecting array_find() to return false on no match like reset() — it returns null, so check with '=== null' not '=== false'.
• Using array_find() when you need all matches — use array_filter() for multiple results.
• Forgetting array_any() and array_all() exist — 'count(array_filter(...)) > 0' is a common pattern these replace cleanly.
• Using these functions in PHP < 8.4 — they are not available; polyfill with a helper function or upgrade.

Code Examples

<?php
// ❌ Verbose first-match patterns
$firstAdmin = null;
foreach ($users as $user) {
    if ($user['role'] === 'admin') {
        $firstAdmin = $user;
        break;
    }
}

// Or the filter+reset hack
$admins = array_filter($users, fn($u) => $u['role'] === 'admin');
$firstAdmin = reset($admins); // false if empty, not null

<?php
// ✅ PHP 8.4 — clean, intent-revealing
$firstAdmin = array_find($users, fn($u) => $u['role'] === 'admin');
// Returns null if not found (not false)

$adminKey = array_find_key($users, fn($u) => $u['role'] === 'admin');

$hasAdmin  = array_any($users, fn($u) => $u['role'] === 'admin');
$allActive = array_all($users, fn($u) => $u['active'] === true);

// Null-safe chaining when element may not exist
$email = array_find($users, fn($u) => $u['id'] === 42)?->email;

References

• ↗ https://www.php.net/releases/8.4/en.php
• ↗ https://wiki.php.net/rfc/array_find

Tags

Related Terms