Array Asosiatif PHP: Pasangan Key dan Value

Array asosiatif menyimpan setiap nilai di bawah key yang kamu pilih, ditulis sebagai key => value: $user = ['name' => 'Ada', 'age' => 36];. Baca nilainya dengan $user['name'], lalu tambah atau ubah nilai dengan mengisinya ke key tersebut: $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 bahasa lain, struktur yang sama disebut dictionary, map, atau hash. Di PHP, ini hanyalah array biasa yang key-nya berupa string, bukan 0, 1, 2.

Menambah, mengubah, dan menghapus pasangan

Mengisi key yang belum ada akan menambahkannya di akhir. Mengisi key yang sudah ada akan mengganti nilainya dan mempertahankan posisinya. unset() menghapus sebuah pasangan.

<?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() tidak membantu di sini: fungsi itu hanya bisa menambahkan nilai dengan key numerik. Untuk menambah beberapa pasangan sekaligus, pakai array_merge($stock, $more), yang membuat nilai baru menang, atau $stock + $more, yang membuat key yang sudah ada tetap memakai nilainya; halaman array_merge membandingkan keduanya.

Menelusuri key dan nilai dengan loop

foreach ($array as $key => $value) menelusuri pasangan-pasangannya sesuai urutan penambahan. Hilangkan $key => kalau kamu hanya butuh nilainya.

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

Mengambil semua key atau semua nilai

array_keys() mengembalikan key sebagai list biasa dan array_values() mengembalikan nilainya, keduanya diindeks ulang mulai dari 0. Beri array_keys() argumen kedua, dan fungsi itu hanya mengembalikan key yang menyimpan nilai tersebut. Begitulah cara mencari semua key untuk sebuah nilai.

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

Untuk satu key, array_search() mengembalikan kecocokan pertama, atau false kalau tidak ada. Halaman array_search menjelaskan kenapa hasilnya harus dibandingkan dengan !== false.

Memeriksa apakah key ada

isset($arr['key']) adalah pengecekan yang biasa dan yang paling cepat, tetapi hasilnya false saat key-nya ada dan berisi null. array_key_exists('key', $arr) mengembalikan true pada kasus itu. Untuk membaca dengan nilai cadangan, operator ?? melakukan keduanya sekaligus.

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

Mengurutkan berdasarkan key atau nilai

ksort() mengurutkan berdasarkan key dan asort() berdasarkan nilai, keduanya menjaga setiap key tetap menempel pada nilainya. krsort() dan arsort() mengurutkan secara terbalik. Jangan pakai sort() pada array asosiatif: fungsi itu membuang key-nya dan menomori ulang mulai dari 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);

Semua fungsi ini mengurutkan secara langsung dan mengembalikan true, jadi $sorted = ksort($arr) memberimu true, bukan array. Urutan khusus memakai uasort() dan uksort().

Membalik, menghitung, dan mengubah ke JSON

Beberapa kode satu baris sering muncul saat bekerja dengan data key-value: array_flip() menukar key dan nilai, array_count_values() menghitung seberapa sering setiap nilai muncul, dan json_encode() mengubah array menjadi objek 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";

Kesalahan umum: membaca key yang tidak ada

Membaca key yang tidak ada mengembalikan null, tetapi PHP milikmu sendiri juga mencetak warning:

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

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

Beri nilai bawaan saat membaca dengan ??, yang tidak pernah memunculkan warning, atau periksa dulu dengan isset() saat kasus key tidak ada butuh cabang sendiri.

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

Di dalam string berkutip ganda, bungkus pencariannya dengan kurung kurawal, "{$user['email']}". Tanpa kurung kurawal, PHP hanya menerima bentuk tanpa kutip "$user[email]", yang mudah salah tulis.