PHP array_search(): Mencari Key dari Sebuah Nilai

array_search($value, $array) mengembalikan key dari elemen pertama yang sama dengan $value, atau false kalau tidak ada elemen yang cocok. Karena key yang ditemukan bisa saja 0, uji hasilnya dengan !== false, seperti pada if (($key = array_search('pear', $fruits)) !== false).

<?php
$fruits = ['apple', 'pear', 'plum'];

$key = array_search('pear', $fruits);
var_dump($key);

$key = array_search('kiwi', $fruits);
var_dump($key);

$prices = ['apple' => 1.20, 'pear' => 0.90];
echo array_search(0.90, $prices), "\n";   // works with string keys too

Kalau kamu hanya butuh jawaban ya atau tidak, in_array() menjawabnya langsung. array_search() dipakai saat kamu perlu tahu di mana nilai itu berada, misalnya untuk mengubah atau menghapusnya.

Jebakan 0 vs false

Bug array_search() yang paling umum: nilainya adalah elemen pertama, key-nya 0, dan if ($key) menganggap 0 sebagai false. Kode itu bilang "tidak ditemukan" untuk nilai yang jelas-jelas ada. Bandingkan dengan !== false, yang hanya cocok dengan false sungguhan.

<?php
$queue = ['Ada', 'Linus', 'Grace'];

if (array_search('Ada', $queue)) {
    echo "Wrong check: found\n";
} else {
    echo "Wrong check: not found\n";      // this runs, key is 0
}

$key = array_search('Ada', $queue);
if ($key !== false) {
    echo "Right check: found at $key\n";
}

!= false punya bug yang sama dengan if ($key), karena 0 == false bernilai true. Hanya operator strict yang bisa membedakan keduanya.

Pencarian strict

Seperti in_array(), array_search() membandingkan dengan == kecuali kamu memberikan true sebagai argumen ketiga. Mode longgar membuat string bisa menemukan angka dan null bisa menemukan 0, sehingga yang dikembalikan adalah key yang tidak kamu duga.

<?php
$ids = [10, 20, 30];
var_dump(array_search('20', $ids));         // loose: "20" == 20
var_dump(array_search('20', $ids, true));   // strict: no match

$stock = ['apples' => 5, 'pears' => 0];
var_dump(array_search(null, $stock));       // null == 0: finds 'pears'
var_dump(array_search(null, $stock, true));

Mencari semua key dengan sebuah nilai

array_search() berhenti di kecocokan pertama. array_keys($array, $value) mengembalikan setiap key yang cocok sebagai array; tambahkan true untuk perbandingan strict. Hasil kosong berarti tidak ada yang cocok, jadi tidak ada kebingungan 0 vs false.

<?php
$seats = ['A1' => 'free', 'A2' => 'taken', 'A3' => 'free', 'A4' => 'taken'];

echo array_search('free', $seats), "\n";          // first only
print_r(array_keys($seats, 'free', true));       // all of them

$colors = ['red', 'blue', 'red', 'green', 'red'];
echo implode(', ', array_keys($colors, 'red')), "\n";

Mencari di array multidimensi dengan array_column

array_search() tidak melihat ke dalam array bersarang. Untuk daftar baris, ambil field yang kamu cari dengan array_column(); posisi di list itu sama dengan nomor barisnya, jadi hasilnya adalah indeks baris tersebut.

<?php
$users = [
    ['id' => 101, 'name' => 'Ada',   'email' => 'ada@example.com'],
    ['id' => 102, 'name' => 'Linus', 'email' => 'linus@example.com'],
    ['id' => 103, 'name' => 'Grace', 'email' => 'grace@example.com'],
];

$i = array_search('linus@example.com', array_column($users, 'email'), true);
if ($i !== false) {
    echo "Found {$users[$i]['name']} with id {$users[$i]['id']}\n";
}

// When rows are looked up often, index them once by the field instead
$byEmail = array_column($users, null, 'email');
echo $byEmail['grace@example.com']['id'], "\n";

array_column() menomori ulang hasilnya mulai dari 0, jadi cara ini hanya cocok saat baris-barisnya bernomor 0, 1, 2 tanpa celah. Setelah unset() atau array_filter(), penomorannya punya celah; jalankan array_values() pada baris-barisnya dulu, atau pakai pencarian dengan key seperti di dua baris terakhir. array_column() membahas lebih jauh bentuk dengan index key.

Pencarian tanpa membedakan huruf besar kecil

array_search() membandingkan string secara persis. Ubah kedua sisi menjadi huruf kecil untuk mengabaikan perbedaan huruf besar kecil. array_map() mempertahankan key, jadi key yang kamu dapat adalah key di array aslinya.

<?php
$tags = ['first' => 'PHP', 'second' => 'Laravel', 'third' => 'MySQL'];

var_dump(array_search('mysql', $tags, true));

$lower = array_map('strtolower', $tags);
$key = array_search(strtolower('mysql'), $lower, true);
var_dump($key);
echo $tags[$key], "\n";

Mencari lalu mengganti atau menghapus

Alasan biasa untuk mencari adalah melakukan sesuatu pada elemen yang ditemukan. Dengan key di tangan, isi nilai baru untuk mengubahnya atau unset() untuk menghapusnya, dan selalu jaga dengan !== false lebih dulu: unset($arr[false]) diam-diam menghapus elemen dengan key 0.

<?php
$todo = ['buy milk', 'call Ada', 'write report'];

$key = array_search('call Ada', $todo, true);
if ($key !== false) {
    $todo[$key] = 'call Ada (done)';
}

$key = array_search('buy milk', $todo, true);
if ($key !== false) {
    unset($todo[$key]);
}

$todo = array_values($todo);   // renumber after unset
print_r($todo);