PHP array_search()：查找值对应的键

array_search($value, $array) 返回第一个等于 $value 的元素的键，如果没有匹配的元素则返回 false。因为找到的键可能是 0，所以要用 !== false 检查结果，例如 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

如果你只需要知道有没有，in_array() 会直接告诉你。array_search() 用于你需要知道值在哪里的时候，比如要修改或删除它。

0 和 false 的陷阱

最常见的 array_search() bug：要找的值是第一个元素，它的键是 0，而 if ($key) 把 0 当成了假。于是值明明就在那里，代码却说“没找到”。用 !== false 来比较，它只匹配真正的 false。

<?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 和 if ($key) 有同样的 bug，因为 0 == false 的结果是 true。只有严格运算符才能把它们区分开。

严格搜索

和 in_array() 一样，除非把 true 作为第三个参数传入，否则 array_search() 使用 == 进行比较。宽松模式下，字符串可以匹配到数字，null 可以匹配到 0，于是返回一个你意想不到的键。

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

找出某个值对应的所有键

array_search() 在第一个匹配处就停止。array_keys($array, $value) 会以数组的形式返回所有匹配的键；加上 true 就是严格比较。空结果表示没有匹配，所以不会有 0 和 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";

用 array_column 搜索多维数组

array_search() 不会查看嵌套数组的内部。对于一组行，先用 array_column() 取出要搜索的字段；这个列表中的位置和行号一一对应，所以结果就是那一行的索引。

<?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() 的输出从 0 开始重新编号，所以只有当行的编号是连续的 0, 1, 2 时才能对得上。经过 unset() 或 array_filter() 之后，编号会出现空缺；这时先对这些行执行 array_values()，或者使用最后两行那种按键查找的方式。array_column() 一页对索引键的用法有更多介绍。

不区分大小写的搜索

array_search() 对字符串做精确比较。要忽略大小写，就把两边都转成小写。array_map() 会保留键，所以你得到的键就是原数组中的键。

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

搜索后替换或删除

搜索通常是为了对找到的元素做点什么。拿到键之后，赋值可以修改它，unset() 可以删除它，但一定要先用 !== false 做检查：unset($arr[false]) 会悄悄删除键为 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);