외부 API 응답 데이터나 복잡한 JSON 구조를 PHP 배열로 파싱한 뒤 3~4단계 깊이에 있는 중첩 키 값을 가져오려다 Warning: Undefined array key 에러를 경험해봤을 것이다.
다만 중간 단계의 키가 존재하는지 검증하기 위해 isset()이나 널 병합 연산자(??)를 체인 형태로 길게 늘어놓다 보니 코드가 지저분해지고 가독성이 심각하게 떨어지는 경우가 많다.
이번에는 중첩된 배열 구조에서도 점(dot) 표기법을 활용해 특정 키의 값을 안전하게 추출하고 기본값까지 처리하는 array_get() 서포트 함수를 어떻게 제작하고 실무에 적용하는지 완벽하게 정리해서 소개하겠다.
PHP에서 깊은 레벨의 다차원 배열에 접근할 때는 항상 중간 키의 존재 여부를 신경 써야 한다.
예를 들어 $data['user']['profile']['name'] 구조에서 $data['user']가 null이거나 배열이 아니라면 PHP 8.0 이상에서는 즉시 E_WARNING 또는 런타임 예외가 발생한다.
| 접근 방식 | 안전성 | 가독성 | 특징 및 단점 |
|---|---|---|---|
직접 차원 접근 ($arr['a']['b']) | 매우 낮음 | 보통 | 중간 키 누락 시 즉시 Warning 에러 발생 |
| isset() 중첩 검사 | 높음 | 매우 큼 | 조건문이나 삼항 연산자가 비대해져 코드 파악이 어려움 |
널 병합 연산자 ($arr['a']['b'] ?? null) | 보통 | 보통 | 중간 요소가 배열이 아닌 경우 런타임 에러 방어 불가 |
| array_get() 서포트 함수 | 매우 높음 | 매우 높음 | 'user.profile.name' 형태의 점 표기법으로 깔끔하고 안전하게 가져옴 |
점 표기법(Dot Notation)은 라라벨(Laravel) 같은 현대적인 프레임워크에서 자주 사용하는 방식이다.
문자열 'user.profile.name'을 explode('.', $key) 함수로 분할하여 배열 키의 배열로 변환한 뒤, 반복문을 순회하면서 데이터의 내부로 한 단계씩 파고드는 구조다.
순회하는 동안 해당 위치의 값이 데이터 형태(배열 또는 ArrayAccess 구현체)인지 검사하고, 키가 없거나 데이터 구조가 다르면 즉시 설정한 기본값(Default)을 반환한다.
실제 프로젝트에서 즉시 가져다 쓸 수 있는 완성형 array_get() 서포트 함수 코드다.
단순 배열뿐만 아니라 ArrayAccess 인터페이스를 구현한 객체에 대해서도 호환되도록 정교하게 예외 처리를 추가했다.
if (!function_exists('array_get')) {
/**
* 점(dot) 표기법을 사용하여 배열에서 안전하게 값을 가져옵니다.
*
* @param array|ArrayAccess $array
* @param string|int|null $key
* @param mixed $default
* @return mixed
*/
function array_get($array, $key, $default = null)
{
if (!is_array($array) && !($array instanceof ArrayAccess)) {
return $default;
}
if (is_null($key)) {
return $array;
}
if (array_key_exists($key, (array)$array)) {
return $array[$key];
}
if (strpos($key, '.') === false) {
return $array[$key] ?? $default;
}
foreach (explode('.', $key) as $segment) {
if ((is_array($array) || $array instanceof ArrayAccess) && isset($array[$segment])) {
$array = $array[$segment];
} else {
return $default;
}
}
return $array;
}
}
개발 과정에서 흔히 발생하는 나쁜 코드 패턴과 array_get() 서포트 함수를 도입했을 때의 올바른 코드를 비교해본다.
✗ 잘못된 코드(안전하지 않거나 가독성이 현저히 낮음)
$response = [
'status' => 200,
'data' => [
'user' => [
'nickname' => 'RedInfo'
]
]
];
// 중간 키 누락 가능성을 방어하기 위해 복잡한 조건문 작성
$email = isset($response['data']) && isset($response['data']['user']) && isset($response['data']['user']['email'])
? $response['data']['user']['email']
: 'no-email@test.com';
// 또는 널 병합 연산자를 썼지만 중간 데이터가 null이면 에러 위험 존재
$zipcode = $response['data']['user']['address']['zipcode'] ?? '00000';
// Warning 발생: Trying to access array offset on value of type null
✓ 올바른 코드(단 한 줄로 기본값까지 안전하게 처리)
$response = [
'status' => 200,
'data' => [
'user' => [
'nickname' => 'RedInfo'
]
]
];
// 서포트 함수 활용
$nickname = array_get($response, 'data.user.nickname', '손님');
$email = array_get($response, 'data.user.email', 'no-email@test.com');
$zipcode = array_get($response, 'data.user.address.zipcode', '00000');
echo "닉네임: {$nickname}\n";
echo "이메일: {$email}\n";
echo "우편번호: {$zipcode}\n";출력 결과:
닉네임: RedInfo
이메일: no-email@test.com
우편번호: 00000
array_get() 서포트 함수는 복잡한 다차원 배열 처리에서 발생할 수 있는 런타임 에러를 방지하고 코드의 가독성을 비약적으로 높여주는 강력한 도구다. 단순한 방어적 코드 작성 습관이 모여서 애플리케이션 전체의 안정성을 결정짓는다는 점을 잊지 말자. 이 글의 서포트 함수 코드를 참고해 프로젝트의 헬퍼 파일에 추가하고 적용하면, 깊게 중첩된 배열 데이터도 안전하고 명확하게 다룰 수 있을 것이다.