PHP in_array(): Bir Değer Dizide Var mı Kontrolü

in_array($needle, $haystack) değer dizide bir yerdeyse true, değilse false döndürür. Aynı türü de şart koşmak için üçüncü argüman olarak true verin, in_array($needle, $haystack, true); varsayılan olarak kullanılması gereken bu katı biçimdir.

<?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() yalnızca değerlere bakar. Bir anahtarın var olup olmadığını kontrol etmek için array_key_exists() veya isset() kullanın.

Katı (strict) parametre

Üçüncü argüman olmadan in_array() karşılaştırmadan önce türleri dönüştüren == ile karşılaştırır. true ile === ile karşılaştırır: değer ve tür ikisi de eşleşmelidir. Dizi sayıları ve dizgeleri karıştırdığı anda fark ortaya çıkar; formlardan, URL'lerden ve CSV dosyalarından gelen verilerde bu yaygındır.

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

Aşağıdaki her hücre, o değer çifti için PHP 8.3'te == ve === operatörlerinin döndürdüğü sonuçtur. Kullandığınız modda aranan değer ve herhangi bir eleman tabloda true veriyorsa in_array() true yanıtını verir. Sekmeler arasında geçin ve null, true ve sayısal dizge satırlarına bakın.

PHP 8'de bir kural değişti: sayısal olmayan bir dizge artık 0 değerine eşit değildir, bu yüzden in_array('abc', [0]) bugün false iken PHP 7'de true idi. PHP 7 için yazılmış kodlar bazen buna dayanıyordu; bu da true verip dönüştürme kurallarına güvenmemek için bir neden daha. Karşılaştırma operatörleri sayfası bunları ayrıntılı olarak açıklar.

Büyük küçük harf duyarsız in_array

in_array() dizgeleri birebir karşılaştırır, bu yüzden 'PHP' ve 'php' farklıdır. Kontrol etmeden önce hem aranan değeri hem diziyi küçük harfe çevirin. mb_strtolower() aksanlı ve Latin olmayan harfleri de işler.

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

Aynı anda birkaç değeri kontrol etme

in_array() tek bir aranan değer alır. Birkaç değer için dizileri küme gibi karşılaştırın: array_diff() eksik olan değerleri döndürür, yani boş bir sonuç hepsinin var olduğu anlamına gelir; array_intersect() ise bulunan değerleri döndürür.

<?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() ve array_intersect() değerleri dizge olarak karşılaştırır, bu yüzden orada 1 ve '1' eşit sayılır.

Çok boyutlu bir dizide in_array

in_array() iç içe dizilerin içinde arama yapmaz. Herhangi bir satırda belirli bir değere sahip bir alan olup olmadığını kontrol etmek için önce o alanı array_column() ile çıkarın, sonra düz listede arayın.

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

Son satır aranan değerin kendisinin de bir dizi olabileceğini gösterir: aynı anahtarlara, değerlere ve sıraya sahip özdeş bir satırla eşleşir.

in_array, array_search ve isset karşılaştırması

Üçü de "orada mı?" sorusunu yanıtlar, ama farklı şeyler döndürür ve farklı hızlarda çalışır:

Değerin nerede olduğunu bilmeniz gerektiğinde array_search() kullanın. Birçok değeri aynı büyük listeye karşı kontrol ettiğinizde listeyi bir kez ters çevirin ki değerleri anahtar olsun, sonra isset() kullanın.

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

Süreler çalıştırmadan çalıştırmaya değişir ama aradaki fark değişmez: isset() araması sabit kalırken in_array() listenin boyutuyla büyür. array_flip() yalnızca dizge ve tam sayı değerlerle çalışır ve tekrarlar tek bir anahtara iner; bu, üyelik kontrolü için önemli değildir.