array_search 返回「鍵名」,in_array 返回「布爾值」;兩者底層遍歷邏輯一致,性能幾乎相同,按「是否需要鍵名」選擇即可。
| 特性 | array_search | in_array |
|---|---|---|
| 返回值 | 找到時返回 鍵名(int/string),未找到返回 false | 找到返回 true,否則 false |
| 嚴格模式 | strict 參數(第三位),true 時檢查類型 | strict 參數(第三位),同左 |
| 典型用途 | 需要知道元素位置以便後續操作(如刪除、替換) | 單純判斷存在性(如權限校驗、標簽檢查) |
| 性能 | O(n) 線性遍歷 | O(n) 線性遍歷 |
<?php
$colors = [0 => 'blue', 1 => 'red', 2 => 'green', 3 => 'red'];
// array_search:返回第一個匹配的鍵
$key = array_search('green', $colors); // 2
$key = array_search('red', $colors); // 1(只返回第一個)
// in_array:只關心是否存在
$hasRed = in_array('red', $colors); // true
$hasYellow = in_array('yellow', $colors); // false
// 嚴格模式對比
$mixed = [0, '0', 1, '1'];
var_dump(array_search(0, $mixed)); // int(0)
var_dump(array_search(0, $mixed, true)); // int(0) 嚴格模式下 0 !== '0'
var_dump(in_array('0', $mixed, true)); // true 找到字符串 '0'
WordPress 核心代碼中的典型用法:
public function add_rewrite_tag(string $tag, string $regex, string $query) {
// 查找 tag 是否已存在於 rewritecode 陣列中
$position = array_search($tag, $this->rewritecode, true);
if ($position !== false && $position !== null) {
// 存在則直接覆蓋對應位置的 regex 和 query
$this->rewritereplace[$position] = $regex;
$this->queryreplace[$position] = $query;
} else {
// 不存在則追加
$this->rewritecode[] = $tag;
$this->rewritereplace[] = $regex;
$this->queryreplace[] = $query;
}
}
這裡 必須獲取鍵名 $position 以便精確更新關聯陣列,若用 in_array 只能知道存在,無法定位位置,還需額外遍歷。
in_array ~ 2.1ms、array_search ~ 2.3ms,差異可忽略。$lookup = array_flip($arr),則 isset($lookup[$val]) 為 O(1)。true,避免 0 == 'abc' 導致的誤判。if (array_search(...) !== false),切勿用 if (array_search(...)),因鍵名 0 會被當作 false。array_walk_recursive。array_flip + isset 或資料庫/Redis 集合。| 函數 | 用途 | 返回 |
|---|---|---|
array_keys($arr, $val) | 獲取所有匹配值的鍵名 | 鍵名陣列 |
array_key_exists($key, $arr) | 檢查鍵名是否存在 | bool |
isset($arr[$key]) | 檢查鍵名存在且值非 null | bool(比 array_key_exists 快) |
array_column($arr, 'col') | 提取多維陣列單列 | 值陣列 |
需要位置用 array_search,只需判斷用 in_array,大數據用 array_flip+isset。 牢記 strict=true 與 !== false 判斷,寫出零 Bug 代碼。