الدالة array_column() في PHP: استخراج عمود من الصفوف

تعيد array_column($rows, $column) قيمة $column من كل صف في قائمة من الصفوف. تحوّل جدولًا من السجلات إلى مصفوفة مسطحة لحقل واحد، وهذا ما تحتاجه قبل implode أو in_array أو array_sum أو array_search.

<?php
$users = [
    ["id" => 3, "name" => "Ada", "email" => "ada@example.com"],
    ["id" => 7, "name" => "Bob", "email" => "bob@example.com"],
    ["id" => 9, "name" => "Cy", "email" => "cy@example.com"],
];

$emails = array_column($users, "email");
print_r($emails);

echo implode(", ", array_column($users, "name")), "\n";

يمكن أن تأتي الصفوف من أي مكان: استجابة JSON بعد فك ترميزها، أو ملف CSV، أو استعلام قاعدة بيانات أعاد مصفوفة من المصفوفات الترابطية.

استخدام مفتاح الفهرس لبناء أزواج المفتاح والقيمة

يسمّي الوسيط الثالث حقلًا تصبح قيمته مفتاح كل نتيجة. array_column($users, 'name', 'id') هي الطريقة المعتادة لبناء جدول بحث من المعرّف إلى الاسم، مثلًا لقائمة <select>.

<?php
$users = [
    ["id" => 3, "name" => "Ada", "role" => "admin"],
    ["id" => 7, "name" => "Bob", "role" => "editor"],
    ["id" => 9, "name" => "Cy", "role" => "viewer"],
];

$names = array_column($users, "name", "id");
print_r($names);

echo $names[7], "\n";

إذا تشارك صفان قيمة الفهرس نفسها، يستبدل الصف اللاحق السابق.

فهرسة الصفوف كاملة بالمعرّف مع null

مرّر null عمودًا لتحتفظ بكل صف كاملًا، بمفتاح جديد من حقل الفهرس. عندها يصبح البحث عن صف بمعرّفه وصولًا مباشرًا بالمفتاح بدل حلقة.

<?php
$products = [
    ["sku" => "A12", "name" => "Lamp", "price" => 29],
    ["sku" => "B07", "name" => "Desk", "price" => 199],
    ["sku" => "C33", "name" => "Chair", "price" => 89],
];

$bySku = array_column($products, null, "sku");

$sku = "B07";
if (isset($bySku[$sku])) {
    echo "{$bySku[$sku]['name']} costs {$bySku[$sku]['price']}\n";
}

print_r(array_keys($bySku));

ابنِ الفهرس مرة واحدة فيصبح كل بحث بعده فوريًا، وهذا مهم عندما تبحث عن معرّفات كثيرة في حلقة.

إيجاد صف بـ array_column وarray_search

لمعرفة أي صف يحمل قيمة معينة، ابحث في العمود واستخدم الموضع الذي تحصل عليه. افحص النتيجة بـ !== false، لأن التطابق في الصف الأول يعيد 0.

<?php
$users = [
    ["name" => "Ada", "email" => "ada@example.com"],
    ["name" => "Bob", "email" => "bob@example.com"],
    ["name" => "Cy", "email" => "cy@example.com"],
];

$wanted = "bob@example.com";
$index = array_search($wanted, array_column($users, "email"));

if ($index !== false) {
    echo "Found: {$users[$index]['name']} at position $index\n";
} else {
    echo "No user with $wanted\n";
}

// Just checking existence
var_dump(in_array("zoe@example.com", array_column($users, "email"), true));

يعتمد هذا على أن مفاتيح $users هي 0, 1, 2، لأن array_column تعيد قائمة. وإذا صُفّيت المصفوفة وفيها فجوات، فاستدعِ array_values($users) أولًا. وتشرح صفحة array_search فخ false مقابل 0 بالتفصيل.

جمع عمود أو عدّه أو حساب متوسطه

تتلاءم array_column مع الدوال الرياضية المساعدة: استخرج الحقل، ثم اجمعه.

<?php
$cart = [
    ["item" => "Book", "qty" => 2, "price" => 12.5],
    ["item" => "Pen", "qty" => 10, "price" => 1.2],
    ["item" => "Bag", "qty" => 1, "price" => 30.0],
];

$qtys = array_column($cart, "qty");
echo "Items: " . array_sum($qtys) . "\n";

$prices = array_column($cart, "price");
echo "Most expensive: " . max($prices) . "\n";
echo "Average price: " . round(array_sum($prices) / count($prices), 2) . "\n";

$total = array_sum(array_map(fn($row) => $row["qty"] * $row["price"], $cart));
echo "Total: $total\n";

لقيمة محسوبة من عدة حقول، مثل الكمية مضروبة في السعر، تكون array_map هي الأداة، كما في السطر الأخير.

array_column مع الكائنات

مع قائمة من الكائنات، تقرأ array_column الخصائص العامة. ولا ترى الخصائص الخاصة والمحمية.

<?php
class User
{
    public function __construct(
        public int $id,
        public string $name,
        private string $password,
    ) {}
}

$users = [
    new User(1, "Ada", "x"),
    new User(2, "Bob", "y"),
];

print_r(array_column($users, "name", "id"));
var_dump(array_column($users, "password"));

يعيد الاستدعاء الثاني مصفوفة فارغة: password خاصة، فيُتخطى كل كائن.

تُتخطى الصفوف التي ينقصها حقل

لا تضع array_column قيمة بديلة لصف ينقصه الحقل. قد تكون النتيجة أقصر من المُدخل، فلا تعود مواضعها مطابقة للصفوف.

<?php
$people = [
    ["name" => "Ada", "phone" => "555-0101"],
    ["name" => "Bob"],
    ["name" => "Cy", "phone" => "555-0199"],
];

print_r(array_column($people, "phone"));

// Keep the link to each person with an index key
print_r(array_column($people, "phone", "name"));

في النتيجة الأولى رقمان للهاتف دون أي إشارة إلى أن Bob ليس لديه رقم. ومع الاسم مفتاحًا للفهرس، يمكنك أن ترى لمن كل رقم، وهي الصيغة الأكثر أمانًا كلما أمكن أن ينقص الحقل بعض الصفوف.