基本語法
bool in_array ( mixed $needle , array $haystack [, bool $strict = false ] )
核心陷阱:預設鬆散比較 (==)
<?php
$arr = [0, 1, 2];
// 字串 '' 轉數字為 0 → 匹配到 0
var_dump(in_array('', $arr)); // bool(true) ⚠️ 意外!
// 字串 'foo' 轉數字為 0 → 匹配到 0
var_dump(in_array('foo', $arr)); // bool(true) ⚠️ 危險!
// null 轉數字為 0
var_dump(in_array(null, $arr)); // bool(true) ⚠️
// false 轉數字為 0
var_dump(in_array(false, $arr)); // bool(true) ⚠️
?>
解決方案:啟用嚴格模式 (第三參數 true)
<?php
$arr = [0, 1, 2];
var_dump(in_array('', $arr, true)); // bool(false) ✅
var_dump(in_array('foo', $arr, true)); // bool(false) ✅
var_dump(in_array(null, $arr, true)); // bool(false) ✅
var_dump(in_array(false, $arr, true)); // bool(false) ✅
var_dump(in_array(0, $arr, true)); // bool(true) ✅
var_dump(in_array('0', $arr, true)); // bool(false) 型別不同
?>
型別比較規則對照 (strict=true 時)
| needle | haystack 值 | strict=false | strict=true |
| 0 | '0' | true | false (int vs string) |
| 0 | false | true | false (int vs bool) |
| 0 | null | true | false |
| '' | 0 | true | false |
| '1' | 1 | true | false |
| 1.0 | 1 | true | false (float vs int) |
| [1] | [1] | true | true (陣列結構相同) |
| object | same object | true | true (同一實例) |
效能考量
- 時間複雜度 O(n):線性搜尋,大陣列 (>1000 元素) 效能明顯下降。
- 嚴格模式較快:避免型別轉換開銷。
- 大量查找優化:將陣列翻轉為鍵值對,使用
isset($flip[$needle]) O(1) 查找。
<?php
$largeArray = range(1, 10000);
$flip = array_flip($largeArray); // 值變鍵
// O(1) 查找
isset($flip[5000]); // true
isset($flip[99999]); // false
// 注意:array_flip 會移除重複值,若需保留重複不可用此法
?>
相關函數對照
| 函數 | 用途 | 嚴格模式 |
in_array() | 值是否存在 | 支援 |
array_search() | 回傳找到的鍵名 | 支援 |
array_key_exists() | 鍵名是否存在 | 鍵名嚴格比較 |
isset($arr[$key]) | 鍵名存在且非 null | 最快,但 null 值會判定為不存在 |
最佳實踐清單
- 預設啟用 strict=true:
in_array($needle, $haystack, true)。
- 唯一例外:確定陣列元素與搜尋值型別一致 (如皆為整數 ID) 且極度在意效能時,可省略 strict。
- 字串搜尋整數陣列:務必轉型
in_array((int)$str, $intArr, true)。
- 大陣列高頻查找:改用
array_flip + isset 或資料結構調整 (Set、資料庫索引)。
- 物件比較:strict=true 時比較同一實例,非屬性值。需實作介面自定比較邏輯。
結語
in_array() 預設鬆散比較是 PHP 最大的坑之一,導致無數「明明不在陣列卻判定存在」的 Bug。鐵律:永遠加上第三參數 true,除非你完全掌控資料型別且極度在意微小效能差異。大型資料集請改用鍵值查找 (O(1)) 替代線性搜尋 (O(n))。