Hàm in_array() trong PHP: kiểm tra giá trị có trong mảng

in_array($needle, $haystack) trả về true nếu giá trị nằm đâu đó trong mảng và false nếu không. Truyền true làm đối số thứ ba, in_array($needle, $haystack, true), để yêu cầu cả kiểu dữ liệu cũng phải giống; đây là dạng nghiêm ngặt nên dùng mặc định.

<?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() chỉ xét các giá trị. Để kiểm tra một khóa có tồn tại hay không, hãy dùng array_key_exists() hoặc isset().

Tham số strict

Không có đối số thứ ba, in_array() so sánh bằng ==, tức là chuyển đổi kiểu trước khi so sánh. Với true, hàm so sánh bằng ===: cả giá trị lẫn kiểu dữ liệu đều phải khớp. Khác biệt lộ ra ngay khi mảng trộn lẫn số và chuỗi, điều rất hay gặp với dữ liệu từ form, URL và tệp 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

Mỗi ô bên dưới là kết quả == và === trả về cho cặp giá trị đó trong PHP 8.3. in_array() trả lời true nếu needle và một phần tử bất kỳ cho ra true trong bảng, ứng với chế độ bạn dùng. Chuyển qua lại giữa các tab và để ý các hàng null, true và chuỗi số.

Có một quy tắc đã thay đổi trong PHP 8: chuỗi không phải số không còn bằng 0 nữa, nên in_array('abc', [0]) hiện nay là false nhưng từng là true trong PHP 7. Code viết cho PHP 7 đôi khi dựa vào điều đó, thêm một lý do nữa để truyền true và không phụ thuộc vào các quy tắc chuyển đổi. Trang toán tử so sánh giải thích đầy đủ các quy tắc này.

in_array không phân biệt hoa thường

in_array() so sánh chuỗi chính xác từng ký tự, nên 'PHP' và 'php' là khác nhau. Hãy chuyển cả needle lẫn mảng về chữ thường trước khi kiểm tra. mb_strtolower() xử lý được cả chữ có dấu và chữ không thuộc bảng Latin.

<?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));

Kiểm tra nhiều giá trị cùng lúc

in_array() chỉ nhận một needle. Với nhiều giá trị, hãy so sánh các mảng như tập hợp: array_diff() trả về những needle bị thiếu, nên kết quả rỗng nghĩa là có đủ tất cả, còn array_intersect() trả về những needle tìm thấy.

<?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() và array_intersect() so sánh giá trị dưới dạng chuỗi, nên ở đây 1 và '1' được coi là bằng nhau.

in_array trên mảng đa chiều

in_array() không tìm bên trong các mảng lồng nhau. Để kiểm tra xem có hàng nào chứa một trường với giá trị cho trước, hãy lấy trường đó ra trước bằng array_column(), rồi tìm trong danh sách phẳng.

<?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));

Dòng cuối cho thấy needle cũng có thể là một mảng: nó khớp với hàng giống hệt, cùng khóa, cùng giá trị và cùng thứ tự.

in_array, array_search và isset

Cả ba đều trả lời câu hỏi "có hay không?", nhưng trả về kết quả khác nhau và chạy với tốc độ khác nhau:

Dùng array_search() khi bạn cần biết giá trị nằm ở đâu. Khi kiểm tra nhiều giá trị với cùng một danh sách lớn, hãy lật danh sách một lần để giá trị trở thành khóa, rồi dùng 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']));

Thời gian thay đổi sau mỗi lần chạy, nhưng khoảng cách thì không: tra cứu bằng isset() giữ nguyên tốc độ, còn in_array() chậm dần theo kích thước danh sách. array_flip() chỉ dùng được với giá trị là chuỗi và số nguyên, và các giá trị trùng nhau gộp thành một khóa, điều này không ảnh hưởng gì khi chỉ kiểm tra có hay không.