in_array(mixed $needle, array $haystack, bool $strict = false): bool
| 參數 | 說明 | 關鍵行為 |
|---|---|---|
$needle | 搜尋值 | 字串區分大小寫;陣列/物件比較引用 |
$haystack | 搜尋目標陣列 | 遍歷所有元素直到找到 |
$strict | 嚴格模式 | false(預設):鬆散比較 (類型轉換);true:型別+值雙重檢查 |
<?php
$arr = ['100', 200, '300', true, false, null, 'abc'];
var_dump(in_array(100, $arr)); // true (int 100 == string '100')
var_dump(in_array('100', $arr)); // true
var_dump(in_array(1, $arr)); // true (int 1 == true)
var_dump(in_array(true, $arr)); // true
var_dump(in_array(0, $arr)); // true (int 0 == false == null == '')
var_dump(in_array('abc', $arr)); // true
var_dump(in_array('ABC', $arr)); // false (區分大小寫)
/*
經典陷阱:
in_array('foo', [0, 'bar']) → true !!!
因為 'foo' == 0 (字串轉數字為 0)
*/
?>
<?php
$arr = ['1.10', 12.4, 1.13];
var_dump(in_array('12.4', $arr, true)); // false (string !== float)
var_dump(in_array(12.4, $arr, true)); // true (float === float)
var_dump(in_array(1.13, $arr, true)); // true
var_dump(in_array('1.13', $arr, true)); // false (string !== float)
// 陣列搜尋陣列 (需完全相同結構、順序、型別)
$nested = [['a', 'b'], ['c', 'd']];
var_dump(in_array(['a', 'b'], $nested, true)); // true
var_dump(in_array(['b', 'a'], $nested, true)); // false (順序不同)
?>
<?php
// 效能測試
$largeArray = range(1, 100000);
$target = 99999;
$start = hrtime(true);
$result = in_array($target, $largeArray);
echo "in_array 耗時: " . (hrtime(true) - $start) / 1e6 . " ms\n"; // ~2-5ms
// 對比:isset 查找鍵值 O(1)
$keyedArray = array_flip($largeArray); // 值變鍵
$start = hrtime(true);
$result = isset($keyedArray[$target]);
echo "isset 查找耗時: " . (hrtime(true) - $start) / 1e6 . " ms\n"; // ~0.01ms (快 200-500 倍)
?>
<?php
// 初始化一次
$lookup = array_flip($largeArray); // 或 array_fill_keys($largeArray, true)
// 後續查找 O(1)
if (isset($lookup[$value])) { /* 存在 */ }
if (array_key_exists($value, $lookup)) { /* 存在,含 null 值 */ }
// 注意:array_flip 會移除重複值,若需保留重複請用計數陣列
$counts = array_count_values($largeArray);
if ($counts[$value] ?? 0 > 0) { /* 存在 */ }
?>
<?php
$users = [
['id' => 1, 'email' => 'a@b.com'],
['id' => 2, 'email' => 'c@d.com'],
];
// 建立 email -> user 索引
$emailIndex = [];
foreach ($users as $user) {
$emailIndex[$user['email']] = $user;
}
// O(1) 查找
$user = $emailIndex['a@b.com'] ?? null;
?>
超過 1 萬筆或複雜條件,請用 MySQL 索引、Redis Set、Elasticsearch、Meilisearch。
| 場景 | 推薦寫法 | 理由 |
|---|---|---|
| 檢查 ID 白名單 | isset($whitelist[$id]) | O(1)、嚴格型別 |
| 檢查字串在列表中 | in_array($str, $list, true) | 嚴格模式避免型別轉換陷阱 |
| 檢查枚舉值 | in_array($val, Enum::cases(), true) | PHP 8.1+ Enum 原生支援 |
| 檢查陣列中有物件 | 建立 ID 索引或用 array_filter | in_array 比較物件需同一實例 |
| 不區分大小寫字串搜尋 | in_array(strtolower($needle), array_map('strtolower', $haystack)) | 或預先建立小寫索引陣列 |
<?php
// PHP 8.0+ 無 array_any,自行實作
function array_any(array $array, callable $predicate): bool
{
foreach ($array as $key => $value) {
if ($predicate($value, $key)) return true;
}
return false;
}
// 使用:物件屬性比較
$found = array_any($users, fn($u) => $u->email === 'target@example.com');
?>
in_array('foo', [0]) === true,**永遠加上 true 啟用嚴格模式**array_flip + isset() 達到 O(1)in_array$allowedIds、$validStatuses 而非 $arr掌握這些原則,能避免 90% 的 in_array 相關 Bug 與效能問題。