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') היא הדרך הרגילה לבנות טבלת חיפוש מ-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";

אם לשתי שורות יש אותו ערך אינדקס, השורה המאוחרת דורסת את המוקדמת.

מתן מפתחות לשורות שלמות לפי id עם null

העבירו null כעמודה כדי לשמור כל שורה מלאה, עם מפתח חדש לפי שדה האינדקס. חיפוש שורה לפי id הופך אז לגישה ישירה למפתח במקום לולאה.

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

בתוצאה הראשונה יש שני טלפונים ואין שום רמז לכך שלבוב לא היה טלפון. עם השם כמפתח האינדקס, אפשר לראות של מי כל מספר, וזו הצורה הבטוחה יותר בכל פעם שלחלק מהשורות עשוי לחסור השדה.