in_array() 是 PHP 最常用的陣列搜尋函式,用於檢查某值是否存在於陣列中。然而,其鬆散比較預設行為、大小寫敏感特性與大型陣列效能問題常導致難以發現的 Bug。本文全面解析語法、參數、型別比較機制、效能優化與最佳實踐。
bool in_array ( mixed $needle , array $haystack [, bool $strict = false ] )
$needle:搜尋目標值(支援任意型別,PHP 4.2.0+ 支援陣列)$haystack:被搜尋的陣列$strict:嚴格模式,預設 false。設為 true 時同時檢查值與型別true 找到、false 未找到PHP 會嘗試型別轉換後比較,導致驚人結果:
<?php
$arr = [0, 'apple', '123', true, null, false];
var_dump(in_array('0', $arr)); // true ('0' == 0)
var_dump(in_array('apple', $arr)); // true
var_dump(in_array(123, $arr)); // true (123 == '123')
var_dump(in_array(1, $arr)); // true (1 == true)
var_dump(in_array('', $arr)); // true ('' == false == 0)
var_dump(in_array(null, $arr)); // true (null == false)
?>
同時比較值與型別,無隱性轉換:
<?php
$arr = ['1.10', 12.4, 1.13];
var_dump(in_array('12.4', $arr, true)); // false(字串 vs 浮點數)
var_dump(in_array(12.4, $arr, true)); // true(浮點數 vs 浮點數)
var_dump(in_array(1.13, $arr, true)); // true
var_dump(in_array('1.13', $arr, true)); // false(字串 vs 浮點數)
?>
字串比較永遠區分大小寫,無論 $strict 設定:
<?php
$os = ['Mac', 'NT', 'Irix', 'Linux'];
var_dump(in_array('Irix', $os)); // true
var_dump(in_array('irix', $os)); // false(小寫)
var_dump(in_array('mac', $os)); // false(小寫)
// 不分大小寫搜尋解法:
function in_array_ci($needle, $haystack) {
return in_array(strtolower($needle), array_map('strtolower', $haystack));
}
?>
<?php
$allowedFruits = ['apple', 'orange', 'banana', 'grape'];
$submitted = $_POST['fruits'] ?? []; // 陣列
$invalid = array_diff($submitted, $allowedFruits);
if ($invalid) {
throw new InvalidArgumentException('非法水果:' . implode(', ', $invalid));
}
// 等價於逐一檢查:
// foreach ($submitted as $fruit) {
// if (!in_array($fruit, $allowedFruits, true)) { ... }
// }
?>
<?php
function deepInArray($needle, $haystack, $strict = false) {
foreach ($haystack as $value) {
if (is_array($value)) {
if (deepInArray($needle, $value, $strict)) return true;
} elseif (($strict && $value === $needle) || (!$strict && $value == $needle)) {
return true;
}
}
return false;
}
$data = [1, 2, [3, 4, [5, 6]], 7];
var_dump(deepInArray(5, $data)); // true
?>
<?php
class User {
public function __construct(public int $id, public string $name) {}
}
$users = [new User(1, 'Alice'), new User(2, 'Bob')];
$target = new User(1, 'Alice');
var_dump(in_array($target, $users)); // false(不同物件實例)
// 解法 1:自訂比較(PHP 8.1+ readonly class 可用)
// 解法 2:提取 ID 陣列比較
$ids = array_column($users, 'id');
var_dump(in_array(1, $ids)); // true
?>
in_array():O(n) 線性搜尋,每次遍歷整個陣列| 場景 | 優化策略 | 複雜度 | 代碼示例 |
|---|---|---|---|
| 頻繁查詢靜態陣列 | 翻轉鍵值用 isset() | O(1) | $lookup = array_flip($arr); isset($lookup[$val]) |
| 頻繁查詢動態陣列 | 維護 SplObjectStorage 或 Set 型別 | O(1) | 使用 Ds\Set (PECL ds) |
| 單次查詢大陣列 | in_array() 可接受 | O(n) | — |
| 需索引位置 | array_search() | O(n) | 回傳鍵名或 false |
<?php
$arr = range(1, 100000);
$lookup = array_flip($arr);
$start = microtime(true);
for ($i = 0; $i < 1000; $i++) in_array(50000, $arr);
echo "in_array: " . (microtime(true) - $start) . "s\n"; // ~0.8s
$start = microtime(true);
for ($i = 0; $i < 1000; $i++) isset($lookup[50000]);
echo "isset+flip: " . (microtime(true) - $start) . "s\n"; // ~0.0002s (快 4000 倍)
?>
0 == 'string' 為 true → 永遠加上 true 參數in_array(0.1 + 0.2, [0.3]) 可能 false → 使用 round() 或字串比較in_array(['a'], [['a'], 'b']) 為 true,但嚴格模式需完全相同結構| 需求 | 推薦函式 | 備註 |
|---|---|---|
| 檢查鍵名存在 | array_key_exists() / isset() | isset 更快但不檢查 null 值 |
| 取得鍵名 | array_search() | 找到回傳鍵名,否則 false |
| 計算出現次數 | array_count_values() | 回傳值=>次數陣列 |
| 過濾陣列 | array_filter() | 可用回呼函式 |
| 交集/差集 | array_intersect() / array_diff() | 集合運算 |
in_array() 看似簡單,實則暗藏型別轉換、大小寫、效能等多重陷阱。鐵律:生產環境永遠使用 in_array($needle, $haystack, true) 嚴格模式。對於高頻查詢場景,務必建立鍵值查找表(array_flip())或使用專用資料結構,將 O(n) 降為 O(1)。理解底層機制,才能寫出正確且高效的 PHP 代碼。