الدالة 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.