Mảng kết hợp trong PHP: cặp khóa và giá trị

Mảng kết hợp (associative array) lưu mỗi giá trị dưới một khóa do bạn chọn, viết dạng key => value: $user = ['name' => 'Ada', 'age' => 36];. Đọc một giá trị bằng $user['name'], và thêm hoặc sửa giá trị bằng cách gán vào khóa của nó: $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);

Ở các ngôn ngữ khác, cấu trúc này được gọi là từ điển (dictionary), map hay hash. Trong PHP nó chỉ là một mảng bình thường có khóa là chuỗi thay vì 0, 1, 2.

Thêm, sửa và xóa cặp

Gán vào một khóa chưa tồn tại sẽ thêm khóa đó vào cuối. Gán vào một khóa đã có sẽ thay giá trị và giữ nguyên vị trí của nó. unset() xóa một cặp.

<?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() không giúp được gì ở đây: nó chỉ nối thêm giá trị với khóa số. Để thêm nhiều cặp cùng lúc, dùng array_merge($stock, $more), khi đó giá trị mới thắng, hoặc $stock + $more, khi đó khóa có sẵn giữ giá trị cũ; trang array_merge so sánh hai cách này.

Duyệt khóa và giá trị

foreach ($array as $key => $value) đi qua các cặp theo thứ tự chúng được thêm vào. Bỏ $key => đi khi bạn chỉ cần giá trị.

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

Lấy mọi khóa hoặc mọi giá trị

array_keys() trả về các khóa dưới dạng danh sách thường và array_values() trả về các giá trị, cả hai đều được đánh số lại từ 0. Truyền thêm đối số thứ hai cho array_keys() thì hàm chỉ trả về những khóa chứa giá trị đó, đây là cách tìm mọi khóa ứng với một giá trị.

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

Với một khóa, array_search() trả về kết quả khớp đầu tiên, hoặc false khi không có. Trang array_search giải thích vì sao bạn phải so sánh kết quả đó với !== false.

Kiểm tra khóa có tồn tại không

isset($arr['key']) là cách kiểm tra thông dụng và nhanh nhất, nhưng nó trả về false khi khóa tồn tại mà chứa null. Trong trường hợp đó, array_key_exists('key', $arr) trả về true. Để đọc kèm giá trị dự phòng, toán tử ?? làm cả hai việc cùng lúc.

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

Sắp xếp theo khóa hoặc theo giá trị

ksort() sắp xếp theo khóa và asort() sắp xếp theo giá trị, cả hai đều giữ mỗi khóa gắn với giá trị của nó. krsort() và arsort() sắp xếp theo chiều ngược lại. Đừng dùng sort() cho mảng kết hợp: hàm này bỏ hết khóa và đánh số lại từ 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);

Tất cả các hàm này sắp xếp ngay trên mảng và trả về true, nên $sorted = ksort($arr) cho bạn true chứ không phải một mảng. Thứ tự tùy chỉnh thì dùng uasort() và uksort().

Đảo, đếm và chuyển sang JSON

Có vài dòng code ngắn mà bạn sẽ gặp đi gặp lại với dữ liệu khóa và giá trị: array_flip() đổi chỗ khóa và giá trị, array_count_values() đếm số lần xuất hiện của mỗi giá trị, còn json_encode() biến mảng thành một đối tượng 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";

Lỗi thường gặp: đọc một khóa không tồn tại

Đọc một khóa không có sẽ trả về null, nhưng PHP trên máy bạn còn in ra một cảnh báo:

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

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

Hãy đọc kèm giá trị mặc định bằng ??, toán tử này không bao giờ cảnh báo, hoặc kiểm tra trước bằng isset() khi trường hợp thiếu khóa cần một nhánh xử lý riêng.

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

Bên trong chuỗi nháy kép, hãy bọc phép tra khóa trong dấu ngoặc nhọn, "{$user['email']}". Không có ngoặc, PHP chỉ chấp nhận dạng không có nháy "$user[email]", rất dễ viết sai.