정의 및 사용 방법
- PHP 버전
- 5+
array_combine() 함수는 두 개의 배열을 사용하여 하나의 연관 배열을 생성합니다.
이때 첫 번째 배열의 값은 키(key)로,
두 번째 배열의 값은 키(key)에 대응하는 값(value)으로 사용합니다.
- 연관 배열(Associative Array)
- PHP에서 연관 배열의 요소는
키 => 값형식의 키와 값의 쌍으로 구성되어 있습니다.
기본 예제
// 1. 키(Key)로 사용할 하나의 배열
$fields = ['username', 'email', 'level'];
// 2. 값(Value)으로 사용할 하나의 배열
$values = ['codingeverybody', 'body@example.com', 'admin'];
// 두 개의 배열을 사용하여 하나의 연관 배열을 생성
$user_info = array_combine($fields, $values);
print_r($user_info);
Array
(
[username] => codingeverybody
[email] => body@example.com
[level] => admin
)
구문
array_combine(array $keys, array $values): array
매개변수
$keys |
키로 사용할 배열입니다.
배열의 값은 연관 배열의 키로 사용됩니다. (키로 사용할 수 없는 값은 문자열로 변환됩니다.) |
|---|---|
$values |
값으로 사용할 배열입니다.
배열의 값은 연관 배열의 값으로 사용됩니다. |
반환 값
첫 번째 배열의 값을 키로, 두 번째 배열의 값을 값으로 결합한(combined) 연관 배열을 반환합니다.
변경 이력
| 버전 | 설명 |
|---|---|
| 8.0.0 | array_combine() 함수는 각 배열의 요소 개수가 서로 다른 경우 이제 ValueError 예외를 발생시킵니다. 이전에는 false를 반환했습니다. |
주의할 점
- 첫 번째 배열의 요소 개수와 두 번째 배열의 요소 개수가 일치하지 않으면 PHP 8.0.0부터
ValueError를 발생시킵니다. 이전 버전에서는E_WARNING을 발생시키고false를 반환했습니다. - 키로 사용되는 첫 번째 배열에 중복된 값이 있으면 마지막에 나오는 값으로 덮어씌워집니다.
키로 사용되는 첫 번째 배열에 중복된 값이 있는 경우
array_combine() 함수는 첫 번째 배열의 값을 키로 사용하여 연관 배열을 생성합니다.
이때 키로 사용되는 값이 중복되면 마지막에 나온 값이 이전 값을 덮어씁니다.
// 키로 사용할 배열 ('name' 값이 중복되어 있음)
$keys = ['name', 'name', 'email'];
// 값으로 사용할 배열
$values = ['Kim', 'Lee', 'kim@example.com'];
// 두 배열을 하나의 연관 배열로 생성합니다.
$result = array_combine($keys, $values);
print_r($result);
array_combine() 함수는 첫 번째 배열의 값을 키로 사용하기 때문에 두 번째 'name' 키가 앞의 'name' 키를 덮어씁니다. 따라서 앞의 값인 'Kim'은 마지막 값인 'Lee'로 덮어씌워집니다.
Array
(
[name] => Lee
[email] => kim@example.com
)
활용 예제
array_combine() 함수는 이미 연관되어 있거나 연관시켜야 할 별도의 키와 값 데이터를 결합해 하나의 연관 배열로 만들면, 키로 값에 접근할 수 있어 직관적이고 유연하게 활용됩니다.
예를 들면, 회원 가입 폼에서 사용하는 필드명과 사용자가 입력한 값이 각각 배열로 관리되고 있을 때, 두 배열을 결합해 하나의 회원 정보 연관 배열로 만들 수 있습니다.
// 폼 필드 이름(키) 배열
$fields = ['username', 'email', 'level'];
// 사용자가 입력한 값 배열
$values = ['codingeverybody', 'body@example.com', 'admin'];
// 두 배열을 결합하여 회원 정보 연관 배열을 생성합니다.
$user_info = array_combine($fields, $values);
// 키로 값에 접근합니다.
echo $user_info['username'] . "님의 등급은 " . $user_info['level'] . "입니다.";
// 출력: codingeverybody님의 등급은 admin입니다.
이처럼 array_combine() 함수는 다음과 같은 상황일 때 사용을 고려해 보세요.
- 데이터베이스 컬럼명 + 조회 결과
- API 응답 필드명 + 응답 데이터
- 폼 필드명 + 입력값
- 설정 항목명 + 설정 값