array_filter() ב-PHP: סינון מערך לפי ערך או מפתח

array_filter($array, $callback) מחזירה את האיברים של $array שעבורם $callback מחזיר true (או כל ערך שמומר ל-true). המערך בא ראשון, ה-callback שני, והאיברים שנשארים שומרים על המפתחות המקוריים שלהם.

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

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

print_r($even);

המפתחות בתוצאה הם 1, 3, 5, 7: המיקומים שהיו לערכים האלה במערך המקורי. הפרט הזה חשוב יותר ממה שהוא נראה, והסעיף שאחרי הבא מראה איך מתמודדים איתו.

הסרת ערכים ריקים ממערך

קראו ל-array_filter בלי callback והיא תסיר כל ערך שמומר ל-false: מחרוזות ריקות, null, false, 0, "0" ומערכים ריקים. זו הדרך המהירה ביותר לנקות את החלקים של explode() או רשימה של שדות טופס.

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

התוצאה הראשונה איבדה גם את "0" ואת 0, שהם לעיתים קרובות נתונים אמיתיים (כמות אפס, ספרה של מיקוד). כשאפס הוא תשובה תקינה, כתבו את ה-callback בעצמכם, כמו בקריאה השנייה. בעמוד empty יש את הרשימה המלאה של ערכים ש-PHP מחשיבה ריקים.

מספור מחדש של התוצאה עם array_values

כיוון שהמפתחות נשמרים, ברשימה מסוננת יכולים להיות פערים. לולאת for מ-0 נתקלת אז במפתחות חסרים, ו-json_encode הופכת את התוצאה לאובייקט JSON במקום למערך. array_values() ממספרת אותה מחדש.

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

סינון לפי מפתח עם ARRAY_FILTER_USE_KEY

הארגומנט השלישי בוחר מה ה-callback מקבל. ARRAY_FILTER_USE_KEY מעבירה רק את המפתח. ARRAY_FILTER_USE_BOTH מעבירה את הערך ואחריו את המפתח.

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

כדי לשמור קבוצה קבועה של מפתחות שאתם כבר מכירים, array_intersect_key($config, array_flip(['db_host', 'db_port'])) עושה את אותו הדבר בלי callback.

סינון מערך רב ממדי

רוב הנתונים האמיתיים הם רשימה של שורות. ה-callback מקבל שורה אחת בכל פעם, כך שבודקים את השדה שצריך.

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

שנו את $maxPrice והריצו שוב. כדי לקבל אחר כך רק את השמות, העבירו את התוצאה ל-array_column: array_column($affordable, 'name').

סינון, אחר כך מיפוי, אחר כך צמצום

array_filter בוחרת איברים, array_map משנה אותם, ו-array_reduce מקפלת את המערך לערך אחד. array_reduce($array, $callback, $initial) קוראת ל-callback עם הסכום המצטבר והאיבר הבא.

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

לסכום פשוט, array_sum($totals) קצרה יותר. array_reduce מצדיקה את מקומה כשהתוצאה היא משהו אחר: מחרוזת, ספירה לכל קבוצה, השורה הגדולה ביותר.

טעות נפוצה: שינוי ערכים בתוך array_filter

ערך ההחזרה של ה-callback רק מחליט אם איבר נשאר. כל דבר אחר שהוא מחשב נזרק, ולכן הקוד הזה לא עושה trim לשום דבר:

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

שנו עם array_map, אחר כך סננו, והוסיפו array_values כשאתם צריכים רשימה נקייה.