PHP assoziative Arrays: Schlüssel/Wert-Paare

Ein assoziatives Array speichert jeden Wert unter einem Schlüssel, den du wählst, geschrieben als key => value: $user = ['name' => 'Ada', 'age' => 36];. Einen Wert liest du mit $user['name'], und du fügst einen hinzu oder änderst ihn, indem du seinem Schlüssel etwas zuweist: $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);

In anderen Sprachen heißt dieselbe Struktur Dictionary, Map oder Hash. In PHP ist es ein ganz normales Array, dessen Schlüssel Strings statt 0, 1, 2 sind.

Paare hinzufügen, ändern und entfernen

Eine Zuweisung an einen Schlüssel, der nicht existiert, fügt ihn am Ende hinzu. Eine Zuweisung an einen existierenden Schlüssel ersetzt seinen Wert und behält seine Position. unset() entfernt ein Paar.

<?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() hilft hier nicht: Es kann nur Werte mit numerischen Schlüsseln anhängen. Um mehrere Paare auf einmal hinzuzufügen, verwendest du array_merge($stock, $more), wo die neuen Werte gewinnen, oder $stock + $more, wo bestehende Schlüssel ihre Werte behalten; die Seite zu array_merge vergleicht beides.

Über Schlüssel und Werte iterieren

foreach ($array as $key => $value) läuft in der Reihenfolge des Hinzufügens über die Paare. Lass $key => weg, wenn du nur die Werte brauchst.

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

Alle Schlüssel oder alle Werte holen

array_keys() liefert die Schlüssel als einfache Liste und array_values() die Werte, beide neu ab 0 indiziert. Gib array_keys() ein zweites Argument, dann liefert es nur die Schlüssel mit diesem Wert, und so findest du jeden Schlüssel zu einem Wert.

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

Für einen einzelnen Schlüssel liefert array_search() den ersten Treffer oder false, wenn es keinen gibt. Die Seite zu array_search erklärt, warum du dieses Ergebnis mit !== false vergleichen musst.

Prüfen, ob ein Schlüssel existiert

isset($arr['key']) ist die übliche und schnellste Prüfung, liefert aber false, wenn der Schlüssel existiert und null enthält. array_key_exists('key', $arr) liefert in diesem Fall true. Zum Lesen mit Ersatzwert erledigt der Operator ?? beides auf einmal.

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

Nach Schlüssel oder Wert sortieren

ksort() sortiert nach Schlüssel und asort() nach Wert, beide lassen jeden Schlüssel an seinem Wert. krsort() und arsort() sortieren absteigend. Verwende kein sort() auf ein assoziatives Array: Es wirft die Schlüssel weg und nummeriert ab 0 neu.

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

Alle diese Funktionen sortieren direkt im Array und liefern true, also bekommst du mit $sorted = ksort($arr) den Wert true und kein Array. Eigene Reihenfolgen verwenden uasort() und uksort().

Umdrehen, zählen und in JSON umwandeln

Bei Schlüssel/Wert-Daten tauchen ein paar Einzeiler immer wieder auf: array_flip() vertauscht Schlüssel und Werte, array_count_values() zählt, wie oft jeder Wert vorkommt, und json_encode() macht aus dem Array ein JSON-Objekt.

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

Typischer Fehler: einen Schlüssel lesen, der nicht da ist

Einen fehlenden Schlüssel zu lesen liefert null, aber dein eigenes PHP gibt außerdem eine Warnung aus:

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

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

Gib dem Lesen mit ?? einen Standardwert, was nie warnt, oder prüfe vorher mit isset(), wenn der fehlende Fall einen eigenen Zweig braucht.

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

In einem String in doppelten Anführungszeichen setzt du den Zugriff in geschweifte Klammern, "{$user['email']}". Ohne sie akzeptiert PHP nur die Form ohne Anführungszeichen, "$user[email]", bei der man sich leicht vertut.