PHP 연관배열: 키와 값 쌍 다루기

연관 배열은 각 값을 직접 고른 키 아래에 저장하며, key => value로 씁니다: $user = ['name' => 'Ada', 'age' => 36];. 값은 $user['name']으로 읽고, 키에 대입해 추가하거나 바꿉니다: $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);

다른 언어에서는 같은 구조를 딕셔너리, 맵, 해시라고 부릅니다. PHP에서는 키가 0, 1, 2 대신 문자열인 평범한 배열입니다.

쌍 추가, 변경, 삭제

존재하지 않는 키에 대입하면 끝에 추가됩니다. 존재하는 키에 대입하면 값이 바뀌고 위치는 그대로입니다. unset()은 쌍을 삭제합니다.

<?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()는 도움이 되지 않습니다. 숫자 키로 값을 덧붙이는 일만 할 수 있습니다. 여러 쌍을 한 번에 추가하려면 새 값이 이기는 array_merge($stock, $more)나, 기존 키가 값을 유지하는 $stock + $more를 쓰세요. 두 방식의 비교는 array_merge 페이지에 있습니다.

키와 값 반복하기

foreach ($array as $key => $value)는 추가된 순서대로 쌍을 순회합니다. 값만 필요하면 $key =>를 생략하세요.

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

모든 키나 모든 값 얻기

array_keys()는 키를 평범한 리스트로, array_values()는 값을 반환하며, 둘 다 0부터 다시 번호가 매겨집니다. array_keys()에 두 번째 인수를 주면 그 값을 가진 키만 반환하며, 이렇게 한 값에 대한 모든 키를 찾습니다.

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

키 하나만 필요하다면 array_search()가 첫 번째 일치를 반환하고, 없으면 false를 반환합니다. 그 결과를 왜 !== false로 비교해야 하는지는 array_search 페이지에서 설명합니다.

키가 있는지 확인하기

isset($arr['key'])가 일반적이고 가장 빠른 확인이지만, 키가 있고 값이 null이면 false를 반환합니다. 그 경우에도 array_key_exists('key', $arr)는 true를 반환합니다. 기본값과 함께 읽을 때는 ?? 연산자가 둘을 한 번에 처리합니다.

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

키나 값으로 정렬하기

ksort()는 키로, asort()는 값으로 정렬하며, 둘 다 각 키를 값과 연결된 채로 유지합니다. krsort()와 arsort()는 역순으로 정렬합니다. 연관 배열에 sort()를 쓰지 마세요. 키를 버리고 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);

이 함수들은 모두 원래 배열을 정렬하고 true를 반환하므로, $sorted = ksort($arr)는 배열이 아니라 true를 줍니다. 사용자 정의 순서에는 uasort()와 uksort()를 씁니다.

뒤집기, 세기, JSON 변환

키와 값 데이터에서 자주 쓰는 한 줄짜리 함수들입니다. array_flip()은 키와 값을 맞바꾸고, array_count_values()는 각 값이 몇 번 나오는지 세며, json_encode()는 배열을 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";

흔한 실수: 없는 키 읽기

없는 키를 읽으면 null이 반환되지만, PHP는 경고도 출력합니다.

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

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

경고가 나지 않는 ??로 기본값을 주거나, 키가 없는 경우에 별도의 분기가 필요하다면 먼저 isset()으로 확인하세요.

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

큰따옴표 문자열 안에서는 조회를 중괄호로 감싸세요: "{$user['email']}". 중괄호가 없으면 PHP는 따옴표 없는 형태 "$user[email]"만 받아들이며, 이는 실수하기 쉽습니다.