list() ופירוק מערכים ב-PHP: [$a, $b] = $arr

[$a, $b] = $array; מפרקת את האיברים של מערך למשתנים נפרדים בשורה אחת: $a מקבל את $array[0], $b מקבל את $array[1]. list($a, $b) = $array; הוא הכתיב הישן של אותו הדבר, ו-['name' => $name] = $user; עושה את זה לפי מפתח.

<?php
$point = [3, 7];
[$x, $y] = $point;
echo "x = $x, y = $y\n";

// Same thing with list()
list($x, $y) = $point;
echo "x = $x, y = $y\n";

// Very common with explode()
[$user, $domain] = explode('@', 'ada@example.com');
echo "User: $user, domain: $domain\n";

השילוב של פירוק עם explode() הוא השימוש הקלאסי: לפצל מחרוזת, לתת שמות לחלקים ולהמשיך הלאה.

דילוג על איברים

השאירו מיקום ריק כדי לדלג עליו. אפשר גם לעצור מוקדם: איברים שלא משתמשים בהם בסוף פשוט נשארים בצד.

<?php
$row = ['2026-03-14', 'Ada', 'Lovelace', 'admin', 'active'];

[, $first, $last] = $row;            // skip the date, ignore the rest
echo "$first $last\n";

[$date, , , $role] = $row;           // skip two in the middle
echo "$date: $role\n";

// Only the time part of a timestamp string
[, $time] = explode(' ', '2026-03-14 09:30:00');
echo "Time: $time\n";

פירוק מערך אסוציאטיבי לפי מפתח

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

<?php
$user = ['id' => 7, 'name' => 'Grace', 'email' => 'grace@example.com', 'age' => 45];

['name' => $name, 'email' => $email] = $user;
echo "$name <$email>\n";

// Rename while you extract
['id' => $userId] = $user;
echo "User #$userId\n";

// Keys can be expressions
$field = 'age';
[$field => $value] = $user;
echo "$field: $value\n";

// Nested: reach inside a nested array
$order = ['id' => 5, 'customer' => ['name' => 'Ada', 'country' => 'UK']];
['id' => $id, 'customer' => ['country' => $country]] = $order;
echo "Order $id ships to $country\n";

תבניות מתקננות באותה צורה גם ברשימות: [[$x1, $y1], [$x2, $y2]] = $line; קורא שתי נקודות בבת אחת. מאז PHP 7.3 משתנה בתבנית יכול להיות גם הפניה, [, &$second] = $counts;, כך ששינוי של $second משנה את המערך.

הצבה אחת משתמשת או במיקומים או במפתחות, אף פעם לא בשניהם. [$a, 'k' => $b] = $arr; נעצרת עם Cannot mix keyed and unkeyed array entries in assignments.

החלפה בין שני משתנים

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

<?php
$a = 'left';
$b = 'right';

[$a, $b] = [$b, $a];
echo "$a $b\n";

// Rotate three values
$x = 1; $y = 2; $z = 3;
[$x, $y, $z] = [$y, $z, $x];
echo "$x $y $z\n";

החזרת כמה ערכים מפונקציה

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

<?php
function minMax(array $numbers): array
{
    return [min($numbers), max($numbers)];
}

[$low, $high] = minMax([4, 9, 1, 7]);
echo "Range: $low to $high\n";

function parseName(string $full): array
{
    $parts = explode(' ', $full, 2);
    return ['first' => $parts[0], 'last' => $parts[1] ?? ''];
}

['last' => $last, 'first' => $first] = parseName('Ada Lovelace');
echo "$last, $first\n";

פירוק בתוך foreach

אותו תחביר עובד בשורת ה-foreach, כך שכל שורה מגיעה כבר מפורקת למשתנים עם שמות. לזה מתכוונים כשמדברים על "foreach עם list()". דפוסי לולאה נוספים נמצאים בעמוד foreach.

<?php
$routes = [
    ['GET', '/users', 'listUsers'],
    ['POST', '/users', 'createUser'],
    ['GET', '/users/{id}', 'showUser'],
];

foreach ($routes as [$method, $path, $handler]) {
    printf("%-5s %-12s -> %s()\n", $method, $path, $handler);
}

$people = [
    ['name' => 'Ada', 'city' => 'London'],
    ['name' => 'Linus', 'city' => 'Helsinki'],
];

foreach ($people as ['name' => $name, 'city' => $city]) {
    echo "$name lives in $city\n";
}

אופרטור הפריסה (...)

שלוש הנקודות פורקות מערך במקום. בליטרל מערך, [...$a, ...$b] ממזג מערכים. בקריאה לפונקציה, f(...$args) מעביר את האיברים כארגומנטים נפרדים. בהגדרת פונקציה, ...$args אוסף ארגומנטים נוספים למערך.

<?php
$fruits = ['apple', 'pear'];
$veg = ['carrot'];
$all = [...$fruits, ...$veg, 'bread'];
print_r($all);

// String keys too (PHP 8.1): later keys win, like array_merge
$defaults = ['color' => 'blue', 'size' => 'M'];
$custom = ['size' => 'L'];
print_r([...$defaults, ...$custom]);

// Unpack into function arguments
$numbers = [4, 9, 1];
echo max(...$numbers), "\n";

// Collect any number of arguments
function total(float ...$amounts): float
{
    return array_sum($amounts);
}
echo total(1.5, 2.5, 6), "\n";

לפני PHP 8.1, פריסה של מערך עם מפתחות מחרוזת הייתה שגיאה; עכשיו מפתחות מחרוזת נשמרים ומפתחות מספריים ממוספרים מחדש, אותם כללים כמו ב-array_merge(). פרמטרים משתנים כמו ...$amounts מוסברים עם שאר סוגי הפרמטרים בעמוד הפונקציות.

טעות נפוצה: פחות איברים ממשתנים

אם המערך קצר מהתבנית, המשתנים החסרים הופכים ל-null ו-PHP מדפיסה אזהרה לכל אחד מהם. זה קורה עם קלט שאתם לא שולטים בו, כמו שורה עם שדות חסרים. עבור [$name, $city, $country] = explode(',', 'Grace'); PHP מדפיסה:

Warning: Undefined array key 1 in /var/www/html/import.php on line 5

Warning: Undefined array key 2 in /var/www/html/import.php on line 5

החליטו מה צריך להיות חלק חסר ורפדו את המערך לפני הפירוק:

<?php
$lines = ['Ada,London,UK', 'Linus,Helsinki', 'Grace'];

foreach ($lines as $line) {
    [$name, $city, $country] = array_pad(explode(',', $line), 3, 'unknown');
    echo "$name | $city | $country\n";
}

בתבניות עם מפתחות, מזגו קודם ברירות מחדל: ['a' => $a, 'b' => $b] = $input + ['a' => null, 'b' => null];. האופרטור + מוסיף רק מפתחות שעוד אין ב-$input.