PHP in_array(): 배열에 값이 있는지 확인하기

in_array($needle, $haystack)는 값이 배열 어딘가에 있으면 true, 없으면 false를 반환합니다. 세 번째 인수로 true를 넘겨 in_array($needle, $haystack, true)로 쓰면 타입까지 같아야 하며, 기본적으로 쓸 형태는 이 엄격한 형태입니다.

<?php
$roles = ['admin', 'editor', 'viewer'];

var_dump(in_array('editor', $roles));
var_dump(in_array('owner', $roles));

if (in_array('admin', $roles, true)) {
    echo "Show the admin menu\n";
}

in_array()는 값만 봅니다. 키가 있는지 확인하려면 array_key_exists()나 isset()을 쓰세요.

strict 매개변수

세 번째 인수가 없으면 in_array()는 ==로 비교하며, 비교 전에 타입을 변환합니다. true를 주면 ===로 비교해 값과 타입이 모두 일치해야 합니다. 배열에 숫자와 문자열이 섞이는 순간 차이가 드러나며, 폼, URL, CSV 파일에서 온 데이터에서는 흔한 일입니다.

<?php
$ids = [1, 2, 3];

var_dump(in_array('2', $ids));          // loose: "2" == 2
var_dump(in_array('2', $ids, true));    // strict: string is not int

$flags = [0, 'off'];
var_dump(in_array(null, $flags));       // null == 0
var_dump(in_array(null, $flags, true));

var_dump(in_array(true, ['yes']));      // 'yes' is truthy, so == true
var_dump(in_array('1e1', ['10']));      // both numeric: 10 == 10

아래 각 셀은 PHP 8.3에서 그 값 쌍에 대해 ==와 ===가 반환하는 결과입니다. in_array()는 사용하는 모드의 표에서 찾는 값과 어떤 요소의 조합이 true이면 true를 답합니다. 탭을 바꿔 가며 null, true, 숫자 문자열 행을 보세요.

PHP 8에서 규칙 하나가 바뀌었습니다. 숫자가 아닌 문자열은 더 이상 0과 같지 않으므로 in_array('abc', [0])은 지금은 false지만 PHP 7에서는 true였습니다. PHP 7용 코드가 이것에 의존하기도 했으며, 변환 규칙에 기대지 말고 true를 넘겨야 하는 또 하나의 이유입니다. 규칙 전체는 비교 연산자 페이지에서 설명합니다.

대소문자를 무시하는 in_array

in_array()는 문자열을 정확히 비교하므로 'PHP'와 'php'는 다릅니다. 확인하기 전에 찾는 값과 배열을 모두 소문자로 바꾸세요. mb_strtolower()는 악센트가 있는 글자와 라틴 문자가 아닌 글자도 처리합니다.

<?php
$allowed = ['jpg', 'PNG', 'Gif'];
$ext = 'png';

var_dump(in_array($ext, $allowed, true));

$lower = array_map('strtolower', $allowed);
var_dump(in_array(strtolower($ext), $lower, true));

$cities = ['München', 'Zürich'];
var_dump(in_array('ZÜRICH', $cities, true));
var_dump(in_array(mb_strtolower('ZÜRICH'), array_map('mb_strtolower', $cities), true));

여러 값을 한 번에 확인하기

in_array()는 찾는 값을 하나만 받습니다. 여러 개라면 배열을 집합으로 비교하세요. array_diff()는 없는 값을 반환하므로 빈 결과는 모두 있다는 뜻이고, array_intersect()는 찾은 값을 반환합니다.

<?php
$skills = ['php', 'sql', 'git', 'docker'];

$required = ['php', 'git'];
$hasAll = array_diff($required, $skills) === [];
var_dump($hasAll);

$wanted = ['rust', 'sql'];
$hasAny = array_intersect($wanted, $skills) !== [];
var_dump($hasAny);

print_r(array_diff(['php', 'go'], $skills));   // what is missing

array_diff()와 array_intersect()는 값을 문자열로 비교하므로 여기서는 1과 '1'이 같은 것으로 취급됩니다.

다차원 배열에서 in_array

in_array()는 중첩 배열 안을 검색하지 않습니다. 어떤 행의 필드에 특정 값이 있는지 확인하려면 먼저 array_column()으로 그 필드를 뽑은 다음 평평한 목록에서 검색하세요.

<?php
$users = [
    ['id' => 1, 'email' => 'ada@example.com'],
    ['id' => 2, 'email' => 'linus@example.com'],
];

var_dump(in_array('ada@example.com', $users, true));    // compares whole rows

$emails = array_column($users, 'email');
var_dump(in_array('ada@example.com', $emails, true));

var_dump(in_array(['id' => 2, 'email' => 'linus@example.com'], $users, true));

마지막 줄은 찾는 값 자체가 배열일 수도 있음을 보여 줍니다. 키, 값, 순서가 모두 같은 행과 일치합니다.

in_array, array_search, isset 비교

셋 다 "있는가?"에 답하지만 반환하는 것과 속도가 다릅니다.

값이 어디에 있는지 알아야 한다면 array_search()를 쓰세요. 같은 큰 목록에 대해 많은 값을 확인한다면 목록을 한 번 뒤집어 값이 키가 되게 하고 isset()을 쓰세요.

<?php
$banned = [];
for ($i = 0; $i < 100000; $i++) {
    $banned[] = "user$i";
}
$checks = ['user99999', 'guest', 'user5'];

$start = hrtime(true);
for ($n = 0; $n < 200; $n++) {
    foreach ($checks as $name) {
        in_array($name, $banned, true);
    }
}
printf("in_array: %.1f ms\n", (hrtime(true) - $start) / 1e6);

$set = array_flip($banned);        // values become keys, done once
$start = hrtime(true);
for ($n = 0; $n < 200; $n++) {
    foreach ($checks as $name) {
        isset($set[$name]);
    }
}
printf("isset:    %.1f ms\n", (hrtime(true) - $start) / 1e6);

var_dump(isset($set['user5']), isset($set['guest']));

시간은 실행할 때마다 달라지지만 격차는 그대로입니다. isset() 조회는 일정하게 유지되고 in_array()는 목록 크기에 따라 늘어납니다. array_flip()은 문자열과 정수 값에만 동작하고 중복은 키 하나로 합쳐지지만, 포함 여부 확인에는 문제가 되지 않습니다.