الدالة array_filter() في PHP: تصفية مصفوفة بالقيمة والمفتاح

تعيد array_filter($array, $callback) عناصر $array التي تعيد لها $callback القيمة true (أو أي قيمة تتحول إلى true). المصفوفة أولًا، ودالة الاستدعاء ثانيًا، والعناصر التي تبقى تحتفظ بمفاتيحها الأصلية.

<?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 دون دالة استدعاء فتحذف كل قيمة تتحول إلى 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، وهما كثيرًا ما يكونان بيانات حقيقية (كمية صفر، رقم في رمز بريدي). وعندما يكون الصفر إجابة صحيحة، اكتب دالة الاستدعاء بنفسك، كما في الاستدعاء الثاني. في صفحة 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

يحدد الوسيط الثالث ما تتلقاه دالة الاستدعاء. تمرر 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'])) الشيء نفسه دون دالة استدعاء.

تصفية مصفوفة متعددة الأبعاد

معظم البيانات الحقيقية قائمة من الصفوف. تتلقى دالة الاستدعاء صفًا واحدًا في كل مرة، فتختبر الحقل الذي تحتاجه.

<?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) دالة الاستدعاء بالمجموع الجاري والعنصر التالي.

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

القيمة التي تعيدها دالة الاستدعاء لا تقرر إلا بقاء العنصر. وكل ما تحسبه غير ذلك يُرمى، لذا فهذه الشيفرة لا تشذّب أي شيء:

<?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 عندما تحتاج إلى قائمة نظيفة.