array_filter() w PHP: filtrowanie po wartości i kluczu

array_filter($array, $callback) zwraca elementy $array, dla których $callback zwraca true (albo dowolną wartość, która zamienia się na true). Najpierw tablica, potem callback, a zachowane elementy zachowują swoje oryginalne klucze.

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

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

print_r($even);

Klucze w wyniku to 1, 3, 5, 7: pozycje, które te wartości miały w oryginalnej tablicy. Ten szczegół ma większe znaczenie, niż się wydaje, a przedostatnia sekcja poniżej pokazuje, jak sobie z nim radzić.

Usuwanie pustych wartości z tablicy

Wywołaj array_filter bez callbacku, a usunie każdą wartość, która zamienia się na false: puste stringi, null, false, 0, "0" i puste tablice. To najszybszy sposób na uporządkowanie kawałków z explode() albo listy pól formularza.

<?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));

Pierwszy wynik stracił też "0" i 0, które często są prawdziwymi danymi (ilość zero, cyfra kodu pocztowego). Gdy zero jest poprawną odpowiedzią, napisz callback sam, jak w drugim wywołaniu. Pełną listę wartości, które PHP uznaje za puste, znajdziesz na stronie empty.

Numerowanie wyniku od nowa przez array_values

Ponieważ klucze są zachowane, przefiltrowana lista może mieć luki. Pętla for od 0 trafia wtedy na brakujące klucze, a json_encode zamienia wynik w obiekt JSON zamiast tablicy. array_values() numeruje go od nowa.

<?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";

Filtrowanie po kluczu z ARRAY_FILTER_USE_KEY

Trzeci argument wybiera, co dostaje callback. ARRAY_FILTER_USE_KEY przekazuje tylko klucz. ARRAY_FILTER_USE_BOTH przekazuje wartość, a potem klucz.

<?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
));

Aby zostawić stały, znany zestaw kluczy, array_intersect_key($config, array_flip(['db_host', 'db_port'])) robi to samo bez callbacku.

Filtrowanie tablicy wielowymiarowej

Większość prawdziwych danych to lista wierszy. Callback dostaje po jednym wierszu, więc sprawdzasz to pole, którego potrzebujesz.

<?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";
}

Zmień $maxPrice i uruchom ponownie. Aby potem dostać same nazwy, przekaż wynik do array_column: array_column($affordable, 'name').

Filtrowanie, potem mapowanie, potem redukcja

array_filter wybiera elementy, array_map je zmienia, a array_reduce zwija tablicę do jednej wartości. array_reduce($array, $callback, $initial) wywołuje callback z bieżącą sumą i kolejnym elementem.

<?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";

Dla zwykłej sumy krótsze jest array_sum($totals). array_reduce przydaje się, gdy wynikiem jest coś innego: string, liczba na grupę, największy wiersz.

Częsty błąd: zmiana wartości w array_filter

Wartość zwracana przez callback decyduje tylko o tym, czy element zostaje. Wszystko inne, co callback obliczy, jest wyrzucane, więc ten kod niczego nie przycina:

<?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);

Przekształcaj przez array_map, potem filtruj, a gdy potrzebujesz czystej listy, dodaj array_values.