Tablice asocjacyjne w PHP: pary klucz i wartość

Tablica asocjacyjna przechowuje każdą wartość pod wybranym przez ciebie kluczem, zapisanym jako key => value: $user = ['name' => 'Ada', 'age' => 36];. Wartość odczytasz przez $user['name'], a dodasz lub zmienisz ją, przypisując do jej klucza: $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);

W innych językach ta sama struktura nazywa się słownikiem, mapą albo hashem. W PHP to zwykła tablica, której kluczami są stringi zamiast 0, 1, 2.

Dodawanie, zmiana i usuwanie par

Przypisanie do klucza, który nie istnieje, dodaje go na końcu. Przypisanie do istniejącego klucza zastępuje jego wartość i zachowuje jego pozycję. unset() usuwa parę.

<?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() tu nie pomoże: potrafi tylko dopisywać wartości z kluczami liczbowymi. Aby dodać kilka par naraz, użyj array_merge($stock, $more), gdzie wygrywają nowe wartości, albo $stock + $more, gdzie istniejące klucze zachowują swoje wartości; strona o array_merge porównuje oba sposoby.

Przechodzenie po kluczach i wartościach

foreach ($array as $key => $value) przechodzi po parach w kolejności, w jakiej je dodano. Pomiń $key =>, gdy potrzebujesz tylko wartości.

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

Pobieranie wszystkich kluczy lub wartości

array_keys() zwraca klucze jako zwykłą listę, a array_values() zwraca wartości, obie z nowymi indeksami od 0. Podaj array_keys() drugi argument, a zwróci tylko klucze z tą wartością: tak znajdujesz wszystkie klucze dla danej wartości.

<?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'

Dla jednego klucza array_search() zwraca pierwsze dopasowanie albo false, gdy go nie ma. Strona o array_search wyjaśnia, dlaczego ten wynik trzeba porównywać przez !== false.

Sprawdzanie, czy klucz istnieje

isset($arr['key']) to zwykłe i najszybsze sprawdzenie, ale zwraca false, gdy klucz istnieje i zawiera null. array_key_exists('key', $arr) zwraca w tym przypadku true. Do odczytu z wartością zastępczą operator ?? robi obie rzeczy naraz.

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

Sortowanie po kluczu lub po wartości

ksort() sortuje po kluczu, a asort() po wartości, i obie zostawiają każdy klucz przy jego wartości. krsort() i arsort() sortują odwrotnie. Nie używaj sort() na tablicy asocjacyjnej: wyrzuca klucze i numeruje od nowa od 0.

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

Wszystkie te funkcje sortują w miejscu i zwracają true, więc $sorted = ksort($arr) daje true, a nie tablicę. Własne kolejności obsługują uasort() i uksort().

Odwracanie, liczenie i konwersja do JSON

Kilka jednolinijkowców wraca raz po raz przy danych klucz i wartość: array_flip() zamienia klucze z wartościami, array_count_values() liczy, ile razy pojawia się każda wartość, a json_encode() zamienia tablicę w obiekt JSON.

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

Częsty błąd: odczyt klucza, którego nie ma

Odczyt brakującego klucza zwraca null, ale twoje PHP wypisuje też ostrzeżenie:

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

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

Daj odczytowi wartość domyślną przez ??, który nigdy nie ostrzega, albo najpierw sprawdź przez isset(), gdy brakujący przypadek potrzebuje własnej gałęzi.

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

Wewnątrz stringa w podwójnych cudzysłowach otocz odczyt nawiasami klamrowymi, "{$user['email']}". Bez nich PHP akceptuje tylko formę bez cudzysłowów "$user[email]", w której łatwo o błąd.