배열에서 특정 키가 존재하는지 확인할 때 array_key_exists()와 isset()을 구분 없이 섞어 쓰는 개발자가 많다. 둘 다 '키 존재 확인' 함수처럼 보이지만, NULL 값 처리 방식이 완전히 다르기 때문에 잘못 고르면 예상 밖의 버그가 발생한다. 이번에는 두 함수의 정확한 동작 원리, 언제 어느 것을 써야 하는지, 그리고 실무에서 흔히 하는 실수를 완벽하게 정리했다.
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)
이 차이가 디버깅을 어렵게 만드는 주요 원인이다.
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
✗ 잘못된 방식: 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)로 호출됨
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()보다 약간 느리다. 하지만 차이는 무시할 수준이고, 정확성이 훨씬 중요하다. 성능을 위해 의도를 버리면 버그를 양산한다.
| 상황 | 추천 함수 | 이유 |
|---|---|---|
| 키가 존재하는지만 확인 | array_key_exists() | NULL 값도 감지 |
| 키가 존재하고 의미 있는 값 | isset() | NULL이나 unset 상태 제외 |
| API 응답 처리 (NULL이 명시적 의미) | array_key_exists() | NULL도 응답 데이터의 일부 |
| 사용자 입력 필터링 | isset() | 빈 값(NULL, '')은 입력 없음으로 취급 |
| 설정 옵션 처리 | array_key_exists() | 명시적으로 설정된 모든 값 포함 |
패턴 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;
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 응답 처리, 데이터베이스 옵션, 필터링된 배열 같은 상황에서는 반드시 의도에 맞는 함수를 선택해야 한다. 이 글의 선택 기준표를 참고해 프로젝트마다 일관된 규칙을 적용하면, 배열 접근으로 인한 버그를 대부분 예방할 수 있을 것이다.