PHP array_filter(): filtrar um array por valor ou chave

array_filter($array, $callback) retorna os elementos de $array para os quais $callback retorna true (ou qualquer valor que vira true). O array vem primeiro, o callback depois, e os elementos que ficam mantêm as chaves originais.

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

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

print_r($even);

As chaves no resultado são 1, 3, 5, 7: as posições que esses valores tinham no array original. Esse detalhe importa mais do que parece, e a seção depois da próxima mostra como lidar com ele.

Remover valores vazios de um array

Chame array_filter sem callback e ele remove todo valor que vira false: strings vazias, null, false, 0, "0" e arrays vazios. É o jeito mais rápido de limpar as partes de um explode() ou uma lista de campos de formulário.

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

O primeiro resultado também perdeu "0" e 0, que muitas vezes são dados reais (uma quantidade zero, um dígito de CEP). Quando zero é uma resposta válida, escreva o callback você mesmo, como na segunda chamada. A página sobre empty tem a lista completa de valores que o PHP trata como vazios.

Reindexar o resultado com array_values

Como as chaves são mantidas, uma lista filtrada pode ter buracos. Um laço for a partir de 0 então encontra chaves ausentes, e o json_encode transforma o resultado num objeto JSON em vez de um array. O array_values() renumera.

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

Filtrar por chave com ARRAY_FILTER_USE_KEY

O terceiro argumento escolhe o que o callback recebe. ARRAY_FILTER_USE_KEY passa só a chave. ARRAY_FILTER_USE_BOTH passa o valor e depois a chave.

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

Para manter um conjunto fixo de chaves que você já conhece, array_intersect_key($config, array_flip(['db_host', 'db_port'])) faz o mesmo sem callback.

Filtrar um array multidimensional

A maioria dos dados reais é uma lista de linhas. O callback recebe uma linha por vez, então você testa o campo que precisar.

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

Mude $maxPrice e rode de novo. Para pegar só os nomes depois, passe o resultado para o array_column: array_column($affordable, 'name').

Filtrar, depois mapear, depois reduzir

O array_filter escolhe elementos, o array_map os altera, e o array_reduce condensa o array num único valor. array_reduce($array, $callback, $initial) chama o callback com o total acumulado e o próximo elemento.

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

Para uma soma simples, array_sum($totals) é mais curto. O array_reduce se justifica quando o resultado é outra coisa: uma string, uma contagem por grupo, a maior linha.

Erro comum: alterar valores dentro do array_filter

O valor de retorno do callback só decide se um elemento fica. Qualquer outra coisa que ele calcule é descartada, então este código não aplica trim em nada:

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

Transforme com array_map, depois filtre, e adicione array_values quando precisar de uma lista limpa.