PHP İlişkisel Diziler: Anahtar Değer Çiftleri

İlişkisel bir dizi her değeri sizin seçtiğiniz bir anahtar altında saklar ve key => value olarak yazılır: $user = ['name' => 'Ada', 'age' => 36];. Bir değeri $user['name'] ile okuyun, anahtarına atama yaparak ekleyin ya da değiştirin: $user['email'] = 'ada@example.com';.

<?php
$user = [
    'name' => 'Ada',
    'age'  => 36,
    'city' => 'London',
];

echo $user['name'], "\n";
echo $user['age'], "\n";

$user['email'] = 'ada@example.com';   // add a pair
$user['city']  = 'Paris';             // change a value

print_r($user);

Diğer dillerde aynı yapıya sözlük (dictionary), map veya hash denir. PHP'de anahtarları 0, 1, 2 yerine dizge olan sıradan bir dizidir.

Çift ekleme, değiştirme ve silme

Var olmayan bir anahtara atama yapmak onu sona ekler. Var olan bir anahtara atama yapmak değerini değiştirir ve konumunu korur. unset() bir çifti siler.

<?php
$stock = ['apples' => 10, 'pears' => 4];

$stock['plums'] = 7;      // new key: added at the end
$stock['apples'] = 12;    // existing key: value replaced
$stock['pears']--;        // change in place
unset($stock['plums']);   // remove a pair

print_r($stock);

array_push() burada işe yaramaz: yalnızca sayısal anahtarlı değerler ekleyebilir. Aynı anda birkaç çift eklemek için yeni değerlerin kazandığı array_merge($stock, $more) ya da var olan anahtarların değerlerini koruduğu $stock + $more kullanın; array_merge sayfası ikisini karşılaştırır.

Anahtarlar ve değerler üzerinde dolaşma

foreach ($array as $key => $value) çiftleri eklendikleri sırayla dolaşır. Yalnızca değerlere ihtiyacınız olduğunda $key => kısmını çıkarın.

<?php
$capitals = [
    'France'  => 'Paris',
    'Japan'   => 'Tokyo',
    'Brazil'  => 'Brasília',
];

foreach ($capitals as $country => $capital) {
    echo "The capital of $country is $capital.\n";
}

foreach ($capitals as $capital) {
    echo mb_strtoupper($capital), "\n";
}

Tüm anahtarları veya tüm değerleri alma

array_keys() anahtarları düz bir liste olarak, array_values() ise değerleri döndürür; ikisi de 0'dan yeniden indekslenir. array_keys() fonksiyonuna ikinci bir argüman verirseniz yalnızca o değeri tutan anahtarları döndürür, bir değere ait tüm anahtarları bu şekilde bulursunuz.

<?php
$grades = ['Ada' => 'A', 'Linus' => 'B', 'Grace' => 'A'];

print_r(array_keys($grades));
print_r(array_values($grades));
print_r(array_keys($grades, 'A'));    // keys whose value is 'A'

echo array_search('B', $grades), "\n"; // first key with value 'B'

Tek bir anahtar için array_search() ilk eşleşmeyi, eşleşme yoksa false döndürür. array_search sayfası bu sonucu neden !== false ile karşılaştırmanız gerektiğini açıklar.

Bir anahtarın var olup olmadığını kontrol etme

isset($arr['key']) olağan ve en hızlı kontroldür, ama anahtar var olup null tuttuğunda false döndürür. array_key_exists('key', $arr) bu durumda true döndürür. Varsayılan bir değerle okumak için ?? operatörü ikisini birden yapar.

<?php
$settings = ['theme' => 'dark', 'font' => null];

var_dump(isset($settings['theme']));
var_dump(isset($settings['font']));            // null counts as not set
var_dump(array_key_exists('font', $settings)); // the key is there

$size = $settings['size'] ?? 14;               // default when missing
echo $size, "\n";

Anahtara veya değere göre sıralama

ksort() anahtara, asort() değere göre sıralar; ikisi de her anahtarı değerine bağlı tutar. krsort() ve arsort() ters sırada sıralar. İlişkisel bir dizide sort() kullanmayın: anahtarları atar ve 0'dan yeniden numaralar.

<?php
$population = ['Tokyo' => 37, 'Delhi' => 32, 'Shanghai' => 29, 'Cairo' => 22];

ksort($population);       // A to Z by city
print_r($population);

arsort($population);      // largest value first
print_r($population);

sort($population);        // keys are lost
print_r($population);

Bunların hepsi yerinde sıralar ve true döndürür, bu yüzden $sorted = ksort($arr) size bir dizi değil true verir. Özel sıralamalar için uasort() ve uksort() kullanılır.

Ters çevirme, sayma ve JSON'a dönüştürme

Anahtar değer verileriyle birkaç tek satırlık işlem sık sık karşınıza çıkar: array_flip() anahtarlarla değerleri yer değiştirir, array_count_values() her değerin kaç kez geçtiğini sayar ve json_encode() diziyi bir JSON nesnesine çevirir.

<?php
$codes = ['red' => '#f00', 'green' => '#0f0', 'blue' => '#00f'];

print_r(array_flip($codes));           // look up a name by code

$votes = ['yes', 'no', 'yes', 'yes', 'no'];
print_r(array_count_values($votes));   // value => how many times

echo json_encode($codes), "\n";

Sık yapılan hata: olmayan bir anahtarı okumak

Eksik bir anahtarı okumak null döndürür, ama sizin PHP'niz bir uyarı da yazdırır:

<?php
$user = ['name' => 'Ada'];
echo $user['phone'];

Warning: Undefined array key "phone" in /var/www/html/index.php on line 3

Okumaya hiçbir zaman uyarı vermeyen ?? ile bir varsayılan verin ya da eksik durum için ayrı bir dal gerekiyorsa önce isset() ile kontrol edin.

<?php
$user = ['name' => 'Ada', 'email' => 'ada@example.com'];

$phone = $user['phone'] ?? 'no phone on file';
echo $phone, "\n";

if (isset($user['email'])) {
    echo "Send mail to {$user['email']}\n";
}

Çift tırnaklı bir dizgenin içinde aramayı süslü parantezle sarın, "{$user['email']}". Onlar olmadan PHP yalnızca tırnaksız "$user[email]" biçimini kabul eder ve bunu yanlış yazmak kolaydır.