PHP array_filter() : filtrer un tableau par valeur ou clé

array_filter($array, $callback) renvoie les éléments de $array pour lesquels $callback renvoie true (ou toute valeur convertie en true). Le tableau vient en premier, le callback en second, et les éléments qui restent gardent leurs clés d'origine.

<?php
$numbers = [1, 2, 3, 4, 5, 6, 7, 8];

$even = array_filter($numbers, fn($n) => $n % 2 === 0);

print_r($even);

Les clés du résultat sont 1, 3, 5, 7 : les positions qu'avaient ces valeurs dans le tableau d'origine. Ce détail compte plus qu'il n'y paraît, et la section d'après la suivante montre comment le gérer.

Supprimer les valeurs vides d'un tableau

Appelez array_filter sans callback et elle supprime toutes les valeurs converties en false : chaînes vides, null, false, 0, "0" et tableaux vides. C'est la façon la plus rapide de nettoyer les morceaux d'un explode() ou une liste de champs de formulaire.

<?php
$fields = ["Ada", "", null, "0", 0, "London", false, []];

print_r(array_filter($fields));

// Keep 0 and "0", drop only "" and null
print_r(array_filter($fields, fn($v) => $v !== '' && $v !== null));

Le premier résultat a aussi perdu "0" et 0, qui sont souvent de vraies données (une quantité nulle, un chiffre de code postal). Quand zéro est une réponse valide, écrivez vous-même le callback, comme dans le second appel. La page empty donne la liste complète des valeurs que PHP considère comme vides.

Réindexer le résultat avec array_values

Comme les clés sont gardées, une liste filtrée peut avoir des trous. Une boucle for depuis 0 tombe alors sur des clés manquantes, et json_encode transforme le résultat en objet JSON au lieu d'un tableau. array_values() le renumérote.

<?php
$words = ["apple", "kiwi", "banana", "fig"];

$long = array_filter($words, fn($w) => strlen($w) > 4);

echo json_encode($long), "\n";
echo json_encode(array_values($long)), "\n";

Filtrer par clé avec ARRAY_FILTER_USE_KEY

Le troisième argument choisit ce que reçoit le callback. ARRAY_FILTER_USE_KEY ne passe que la clé. ARRAY_FILTER_USE_BOTH passe la valeur puis la clé.

<?php
$config = [
    "db_host" => "localhost",
    "db_port" => 5432,
    "app_name" => "Shop",
    "app_debug" => false,
];

// Keep only keys that start with db_
print_r(array_filter($config, fn($key) => str_starts_with($key, 'db_'), ARRAY_FILTER_USE_KEY));

$scores = ["ada" => 92, "bob" => 48, "cy" => 75, "dee" => 55];

// Value and key: a passing score and a name longer than two letters
print_r(array_filter(
    $scores,
    fn($score, $name) => $score >= 50 && strlen($name) > 2,
    ARRAY_FILTER_USE_BOTH
));

Pour garder un ensemble fixe de clés que vous connaissez déjà, array_intersect_key($config, array_flip(['db_host', 'db_port'])) fait la même chose sans callback.

Filtrer un tableau multidimensionnel

La plupart des vraies données sont une liste de lignes. Le callback reçoit une ligne à la fois, vous testez donc le champ dont vous avez besoin.

<?php
$products = [
    ["name" => "Keyboard", "price" => 49, "inStock" => true],
    ["name" => "Monitor", "price" => 189, "inStock" => false],
    ["name" => "Mouse", "price" => 19, "inStock" => true],
    ["name" => "Webcam", "price" => 65, "inStock" => true],
];

$maxPrice = 60;

$affordable = array_filter(
    $products,
    fn($p) => $p["inStock"] && $p["price"] <= $maxPrice
);

foreach ($affordable as $p) {
    echo "{$p['name']}: \${$p['price']}\n";
}

Modifiez $maxPrice et relancez. Pour obtenir ensuite seulement les noms, passez le résultat à array_column : array_column($affordable, 'name').

Filtrer, puis mapper, puis réduire

array_filter choisit des éléments, array_map les modifie, et array_reduce ramène le tableau à une seule valeur. array_reduce($array, $callback, $initial) appelle le callback avec le total en cours et l'élément suivant.

<?php
$orders = [
    ["id" => 1, "total" => 120.0, "status" => "paid"],
    ["id" => 2, "total" => 35.5, "status" => "refunded"],
    ["id" => 3, "total" => 80.0, "status" => "paid"],
    ["id" => 4, "total" => 15.0, "status" => "paid"],
];

$paid = array_filter($orders, fn($o) => $o["status"] === "paid");

$totals = array_map(fn($o) => $o["total"], $paid);

$revenue = array_reduce($totals, fn($sum, $t) => $sum + $t, 0);

echo "Paid orders: " . count($paid) . "\n";
echo "Revenue: $revenue\n";

Pour une simple somme, array_sum($totals) est plus court. array_reduce se justifie quand le résultat est autre chose : une chaîne, un compte par groupe, la plus grande ligne.

Erreur fréquente : modifier des valeurs dans array_filter

La valeur de retour du callback décide seulement si un élément reste. Tout ce qu'il calcule d'autre est jeté, donc ce code n'applique trim à rien :

<?php
$names = ["  Ada ", "", " Grace"];

// Looks like it trims, but array_filter keeps the original values
$wrong = array_filter($names, fn($n) => trim($n));
var_dump($wrong);

// Trim first, then filter
$right = array_values(array_filter(array_map('trim', $names)));
var_dump($right);

Transformez avec array_map, puis filtrez, et ajoutez array_values quand il vous faut une liste propre.