외부 API 응답 데이터나 복잡한 JSON 구조를 PHP 배열로 파싱한 뒤 3~4단계 깊이에 있는 중첩 키 값을 가져오려다 Warning: Undefined array key 에러를 경험해봤을 것이다.
다만 중간 단계의 키가 존재하는지 검증하기 위해 isset()이나 널 병합 연산자(??)를 체인 형태로 길게 늘어놓다 보니 코드가 지저분해지고 가독성이 심각하게 떨어지는 경우가 많다.
이번에는 중첩된 배열 구조에서도 점(dot) 표기법을 활용해 특정 키의 값을 안전하게 추출하고 기본값까지 처리하는 array_get() 서포트 함수를 어떻게 제작하고 실무에 적용하는지 완벽하게 정리해서 소개하겠다.

 

1. 중첩 배열 접근 시 발생하는 문제점

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' 형태의 점 표기법으로 깔끔하고 안전하게 가져옴

 

2. array_get() 서포트 함수 설계 원리

점 표기법(Dot Notation)은 라라벨(Laravel) 같은 현대적인 프레임워크에서 자주 사용하는 방식이다.
문자열 'user.profile.name'을 explode('.', $key) 함수로 분할하여 배열 키의 배열로 변환한 뒤, 반복문을 순회하면서 데이터의 내부로 한 단계씩 파고드는 구조다.
순회하는 동안 해당 위치의 값이 데이터 형태(배열 또는 ArrayAccess 구현체)인지 검사하고, 키가 없거나 데이터 구조가 다르면 즉시 설정한 기본값(Default)을 반환한다.

 

3. array_get() 서포트 함수 구현과 실무 활용

실제 프로젝트에서 즉시 가져다 쓸 수 있는 완성형 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;
    }
}

 

4. 흔히 하는 실수와 올바른 활용법

개발 과정에서 흔히 발생하는 나쁜 코드 패턴과 array_get() 서포트 함수를 도입했을 때의 올바른 코드를 비교해본다.

 

나쁜 예: 삼항 연산자와 isset()의 과도한 중첩

✗ 잘못된 코드(안전하지 않거나 가독성이 현저히 낮음)

$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

 

좋은 예: array_get() 함수를 사용한 깔끔한 처리

✓ 올바른 코드(단 한 줄로 기본값까지 안전하게 처리)

$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

 

5. 마무리 및 핵심 정리

array_get() 서포트 함수는 복잡한 다차원 배열 처리에서 발생할 수 있는 런타임 에러를 방지하고 코드의 가독성을 비약적으로 높여주는 강력한 도구다. 단순한 방어적 코드 작성 습관이 모여서 애플리케이션 전체의 안정성을 결정짓는다는 점을 잊지 말자. 이 글의 서포트 함수 코드를 참고해 프로젝트의 헬퍼 파일에 추가하고 적용하면, 깊게 중첩된 배열 데이터도 안전하고 명확하게 다룰 수 있을 것이다.