배열에서 특정 키가 존재하는지 확인할 때 array_key_exists()와 isset()을 구분 없이 섞어 쓰는 개발자가 많다. 둘 다 '키 존재 확인' 함수처럼 보이지만, NULL 값 처리 방식이 완전히 다르기 때문에 잘못 고르면 예상 밖의 버그가 발생한다. 이번에는 두 함수의 정확한 동작 원리, 언제 어느 것을 써야 하는지, 그리고 실무에서 흔히 하는 실수를 완벽하게 정리했다.

 

1단계. 기초 개념 이해하기

array_key_exists()와 isset()은 모두 배열 키 존재 여부를 반환하지만, NULL 값을 다루는 방식이 근본적으로 다르다.

array_key_exists()는 키가 존재하면 TRUE를 반환한다. 그 값이 NULL이든 아무 상관없다. 오직 키의 존재 여부만 본다.

isset()은 키가 존재하면서 동시에 그 값이 NULL이 아니어야 TRUE를 반환한다. 키는 있어도 값이 NULL이면 FALSE를 반환한다.

예를 들어, $arr = ['name' => NULL]이라고 하자.

$arr = ['name' => NULL];

array_key_exists('name', $arr);  // TRUE (키 존재)
isset($arr['name']);              // FALSE (값이 NULL)

이 차이가 디버깅을 어렵게 만드는 주요 원인이다.

 

2단계. 실전 비교 - 각 함수의 동작

array_key_exists() 사용 사례

배열에 키가 존재하는지만 확인할 때 쓴다. 값이 NULL이든 false든 빈 문자열이든 상관없다.

$user = [
    'id' => 1,
    'name' => NULL,
    'email' => '',
    'status' => false
];

// 키 존재 확인만 필요할 때
if (array_key_exists('name', $user)) {
    echo "name 키 존재";
}
// 출력: name 키 존재

isset() 사용 사례

키가 존재하면서 의미 있는 값을 가져야 할 때 쓴다. NULL이나 unset 상태를 걸러낸다.

if (isset($user['name'])) {
    echo $user['name'];
} else {
    echo "name이 없거나 NULL";
}
// 출력: name이 없거나 NULL

 

3단계. 실무 예제 - 데이터 검증과 처리

✗ 잘못된 방식: isset() 만 쓰면 위험한 경우

// API에서 받은 데이터
$post = [
    'title' => 'PHP 배열 가이드',
    'content' => NULL,  // 명시적으로 NULL 설정됨
    'draft' => false
];

// 잘못된 접근
if (isset($post['content'])) {
    $content = $post['content'];
} else {
    $content = '기본값';
}
// $content = '기본값' (NULL이 무시됨)
// 실제로는 'content' 키가 존재했는데도 감지 못함

✓ 올바른 방식: array_key_exists() 사용

// API 응답에서 명시적으로 보낸 NULL 값을 구분해야 할 때
if (array_key_exists('content', $post)) {
    if ($post['content'] !== NULL) {
        $content = $post['content'];
    } else {
        $content = NULL;  // NULL이 의도된 값
    }
} else {
    $content = '기본값';  // 키 자체가 없는 경우
}
// 올바르게 각 상황을 구분할 수 있음

✗ 잘못된 방식: 데이터베이스 옵션 필터링

$options = [
    'timeout' => 30,
    'retry' => false,
    'verify' => NULL
];

// 옵션이 존재하는 모든 키를 처리하려고 할 때
foreach ($options as $key => $value) {
    if (isset($value)) {  // ← 문제!
        applyOption($key, $value);
    }
}
// verify는 NULL이므로 applyOption이 호출 안 됨

✓ 올바른 방식: 모든 명시적 설정을 처리

$options = [
    'timeout' => 30,
    'retry' => false,
    'verify' => NULL
];

// 배열에 존재하는 모든 키를 처리
foreach ($options as $key => $value) {
    applyOption($key, $value);  // NULL도 의도된 값으로 전달
}
// verify도 applyOption('verify', NULL)로 호출됨

 

4단계. 주의사항과 추가 함수 비교

empty()는 쓰지 말 것

empty()는 키 존재를 확인하지 않는다. 키가 없어도 오류가 없지만, '거짓 같은 값'(0, '', false, NULL 등)을 모두 걸러낸다. 의도를 명확하게 드러내려면 쓰면 안 된다.

$data = ['count' => 0];

empty($data['count']);           // TRUE (0은 거짓)
isset($data['count']);           // TRUE (키 존재, 값도 있음)
array_key_exists('count', $data); // TRUE (키 존재)

// 의도를 명확하게 하려면
if (isset($data['count']) && $data['count'] !== 0) {
    // 카운트가 1 이상
}

성능 비교

array_key_exists()가 isset()보다 약간 느리다. 하지만 차이는 무시할 수준이고, 정확성이 훨씬 중요하다. 성능을 위해 의도를 버리면 버그를 양산한다.

 

5단계. 함수 선택 기준
상황 추천 함수 이유
키가 존재하는지만 확인 array_key_exists() NULL 값도 감지
키가 존재하고 의미 있는 값 isset() NULL이나 unset 상태 제외
API 응답 처리 (NULL이 명시적 의미) array_key_exists() NULL도 응답 데이터의 일부
사용자 입력 필터링 isset() 빈 값(NULL, '')은 입력 없음으로 취급
설정 옵션 처리 array_key_exists() 명시적으로 설정된 모든 값 포함

 

6단계. 혼동하기 쉬운 패턴 정리

패턴 1: 필터링된 배열에서 FALSE 값 찾기

$results = [
    'success' => true,
    'error' => false,
    'retry' => NULL
];

// 잘못된 방식 (FALSE를 감지 못함)
if (isset($results['error'])) {
    // FALSE면 여기 들어오지 않음!
}

// 올바른 방식
if (array_key_exists('error', $results)) {
    if ($results['error'] === false) {
        echo "에러 발생";
    }
}

패턴 2: 선택적 필드가 있는 폼 처리

$formData = [
    'name' => 'John',
    'phone' => '',      // 사용자가 비움
    'memo' => NULL      // 필드 없음 (숨겨진 필드)
];

// 명확한 의도
$phone = array_key_exists('phone', $formData) ? $formData['phone'] : 'N/A';
// $phone = '' (사용자가 비워둠)

$memo = $formData['memo'] ?? 'N/A';
// $memo = NULL (필드 존재)

// 의미 있는 값만 저장
$phone = isset($formData['phone']) && $formData['phone'] !== '' 
    ? $formData['phone'] 
    : NULL;

 

7단계. 현대 PHP에서의 권장 방식

PHP 8.0 이상에서는 Null Safe Operator(?->)와 Nullsafe Array Access(?[])가 추가되었다. 복잡한 중첩 배열 처리할 때 가독성이 훨씬 좋다.

// PHP 8.0+ 권장
$user = $data['user'] ?? [];
$name = $user['profile']['name'] ?? 'Unknown';

// 더 간결한 방식 (PHP 8.3+에서는 array_key_first() 등도 활용)
if (count($arr) > 0 && array_key_exists($key, $arr)) {
    // 존재하고 비어있지 않음
}

array_key_exists()와 isset()은 작은 차이로 보이지만, 대규모 애플리케이션에서는 치명적인 버그의 원인이 된다. API 응답 처리, 데이터베이스 옵션, 필터링된 배열 같은 상황에서는 반드시 의도에 맞는 함수를 선택해야 한다. 이 글의 선택 기준표를 참고해 프로젝트마다 일관된 규칙을 적용하면, 배열 접근으로 인한 버그를 대부분 예방할 수 있을 것이다.