PHP list() ve Dizi Ayrıştırma: [$a, $b] = $arr

[$a, $b] = $array; bir dizinin elemanlarını tek satırda ayrı değişkenlere ayırır: $a $array[0], $b $array[1] değerini alır. list($a, $b) = $array; aynı şeyin eski yazımıdır ve ['name' => $name] = $user; bunu anahtara göre yapar.

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

Ayrıştırmayı explode() ile birlikte kullanmak klasik kullanımdır: bir dizgeyi bölün, parçaları adlandırın, devam edin.

Elemanları atlama

Bir konumu atlamak için boş bırakın. Erken de durabilirsiniz: sondaki kullanılmayan elemanlar yok sayılır.

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

İlişkisel bir diziyi anahtara göre ayrıştırma

Anahtarlarla dizideki sıra önemli değildir ve yalnızca ihtiyacınız olan alanları alırsınız. Anahtar => öncesine, değişken sonrasına yazılır.

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

Kalıplar listeler için de aynı şekilde iç içe geçer: [[$x1, $y1], [$x2, $y2]] = $line; iki noktayı aynı anda okur. PHP 7.3'ten beri bir kalıptaki değişken referans da olabilir, [, &$second] = $counts;, yani $second değişince dizi de değişir.

Bir atama ya konumları ya anahtarları kullanır, asla ikisini birden. [$a, 'k' => $b] = $arr; Cannot mix keyed and unkeyed array entries in assignments ile durur.

İki değişkenin yerini değiştirme

İki değerden ters sırada bir dizi oluşturun ve onu geri ayrıştırın. Geçici değişken gerekmez.

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

Bir fonksiyondan birden çok değer döndürme

Bir PHP fonksiyonu tek bir değer döndürür, ama bu değer bir dizi olabilir. Çağrı yerinde ayrıştırmak onu birkaç dönüş değeri gibi okutur. İki üç değerden fazlası için anahtarlar döndürün ki çağıran sırayı karıştıramasın.

<?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 içinde ayrıştırma

Aynı söz dizimi foreach satırında da çalışır, böylece her satır zaten adlandırılmış değişkenlere ayrılmış olarak gelir. "list() ile foreach" denildiğinde kastedilen budur. Daha fazla döngü kalıbı foreach sayfasında.

<?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çma operatörü (...)

Üç nokta bir diziyi yerinde açar. Bir dizi değişmezinde [...$a, ...$b] dizileri birleştirir. Bir fonksiyon çağrısında f(...$args) elemanları ayrı argümanlar olarak verir. Bir fonksiyon tanımında ...$args fazla argümanları bir dizide toplar.

<?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'den önce dizge anahtarlı bir diziyi açmak hataydı; artık array_merge() ile aynı kurallarla dizge anahtarlar korunur ve sayısal anahtarlar yeniden numaralanır. ...$amounts gibi değişken sayıda parametreler diğer parametre türleriyle birlikte fonksiyonlar sayfasında anlatılıyor.

Sık yapılan hata: değişkenlerden az eleman

Dizi kalıptan kısaysa eksik değişkenler null olur ve PHP her biri için bir uyarı yazdırır. Bu, eksik alanları olan bir satır gibi kontrol etmediğiniz girdilerde olur. [$name, $city, $country] = explode(',', 'Grace'); için PHP şunu yazdırır:

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

Eksik bir parçanın ne olması gerektiğine karar verin ve ayrıştırmadan önce diziyi doldurun:

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

Anahtarlı kalıplar için önce varsayılanları birleştirin: ['a' => $a, 'b' => $b] = $input + ['a' => null, 'b' => null];. + operatörü yalnızca $input içinde olmayan anahtarları ekler.