萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP in_array() 函式完整指南:陣列搜尋、嚴格模式、效能考量與常見陷阱

前言

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 未找到

核心機制:鬆散 vs 嚴格比較

預設鬆散比較($strict = 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)
?>

嚴格模式($strict = true)

同時比較值與型別,無隱性轉換:

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

實戰範例與進階用法

範例 1:表單多選欄位驗證

<?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)) { ... }
// }
?>

範例 2:多維陣列搜尋(需自訂遞迴)

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

範例 3:物件陣列搜尋(需實作 __equals 或用 spl_object_id)

<?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) 線性搜尋,每次遍歷整個陣列
  • 陣列 10,000 元素 → 約 10,000 次比較
  • 頻繁在迴圈中呼叫 → 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

效能實測參考(10萬元素陣列,查詢 1000 次)

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

常見陷阱總結

  1. 預設鬆散比較:0 == 'string' 為 true → 永遠加上 true 參數
  2. 浮點數精度:in_array(0.1 + 0.2, [0.3]) 可能 false → 使用 round() 或字串比較
  3. 大小寫敏感:字串搜尋必須注意大小寫
  4. 陣列當 needle (PHP 4.2+):in_array(['a'], [['a'], 'b']) 為 true,但嚴格模式需完全相同結構
  5. null/false/0/'' 混淆:鬆散模式下這些值互相匹配

替代函式快速選擇

需求推薦函式備註
檢查鍵名存在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 代碼。

copyright © 萬盛學電腦網 all rights reserved