in_array() PHP: Cek Apakah Nilai Ada di Array

in_array($needle, $haystack) mengembalikan true jika nilainya ada di suatu tempat di array dan false jika tidak. Berikan true sebagai argumen ketiga, in_array($needle, $haystack, true), agar tipenya juga harus sama; bentuk strict itulah yang sebaiknya kamu pakai secara default.

<?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() hanya melihat nilai. Untuk memeriksa apakah sebuah key ada, pakai array_key_exists() atau isset().

Parameter strict

Tanpa argumen ketiga, in_array() membandingkan dengan ==, yang mengonversi tipe sebelum membandingkan. Dengan true, fungsi ini membandingkan dengan ===: nilai dan tipenya harus sama-sama cocok. Perbedaannya langsung terlihat begitu array mencampur angka dan string, yang umum terjadi pada data dari form, URL, dan file 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

Setiap sel di bawah ini adalah hasil == dan === untuk pasangan nilai tersebut di PHP 8.3. in_array() menjawab true jika needle dan salah satu elemen menghasilkan true di tabel untuk mode yang kamu pakai. Pindah-pindah tab dan perhatikan baris null, true, dan string numerik.

Ada satu aturan yang berubah di PHP 8: string non-numerik tidak lagi sama dengan 0, jadi in_array('abc', [0]) bernilai false sekarang tetapi true di PHP 7. Kode yang ditulis untuk PHP 7 kadang bergantung pada hal itu, satu alasan lagi untuk memberikan true dan tidak bergantung pada aturan konversi. Halaman operator perbandingan menjelaskannya secara lengkap.

in_array tanpa membedakan huruf besar dan kecil

in_array() membandingkan string secara persis, jadi 'PHP' dan 'php' berbeda. Ubah needle dan array-nya menjadi huruf kecil sebelum memeriksa. mb_strtolower() juga menangani huruf beraksen dan non-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));

Memeriksa beberapa nilai sekaligus

in_array() menerima satu needle. Untuk beberapa nilai, bandingkan array-array itu sebagai himpunan: array_diff() mengembalikan needle yang tidak ada, jadi hasil kosong berarti semuanya ada, dan array_intersect() mengembalikan needle yang ditemukan.

<?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() dan array_intersect() membandingkan nilai sebagai string, jadi 1 dan '1' dianggap sama di sana.

in_array pada array multidimensi

in_array() tidak mencari di dalam array bersarang. Untuk memeriksa apakah ada baris yang field-nya bernilai tertentu, ambil field itu dulu dengan array_column(), lalu cari di list yang sudah datar.

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

Baris terakhir menunjukkan bahwa needle-nya sendiri bisa berupa array: needle itu cocok dengan baris yang identik, dengan key, nilai, dan urutan yang sama.

in_array vs array_search vs isset

Ketiganya menjawab "apakah nilainya ada?", tetapi mengembalikan hal yang berbeda dan berjalan dengan kecepatan yang berbeda:

Pakai array_search() saat kamu perlu tahu di mana nilainya berada. Saat kamu memeriksa banyak nilai terhadap list besar yang sama, balik list itu sekali agar nilainya menjadi key, lalu pakai 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']));

Waktunya berubah dari satu run ke run berikutnya, tetapi selisihnya tidak: lookup isset() tetap datar sementara in_array() bertambah seiring ukuran list. array_flip() hanya bekerja untuk nilai string dan integer, dan nilai duplikat melebur menjadi satu key, yang tidak masalah untuk pemeriksaan keanggotaan.