PHP 判斷 JSON 物件/陣列鍵是否存在的正確方法：isset、array_key_exists 與類型檢查

問題現象

<?php
$structure = imap_fetchstructure($conn, $id, FT_UID);
if (array_key_exists('parts', $structure)) { // Warning: array_key_exists() expects parameter 2 to be array, boolean given
    // ...
}

imap_fetchstructure 失敗時返回 false，非陣列，導致 array_key_exists 報警告。

正確解法對比

深度解析

isset() 行為

• 變數不存在 → false
• 變數存在但值為 null → false
• 變數存在且值非 null → true
• 參數可以是任意表達式，不拋出錯誤/警告。

array_key_exists() 行為

• **嚴格要求第二參數為陣列**，否則 E_WARNING。
• 鍵存在且值為 null → true（與 isset 不同）。
• 效能略低於 isset（需檢查陣列結構）。

建議決策樹

if (is_array($data)) {
    // 確定是陣列
    if (array_key_exists($key, $data)) { ... } // 需區分 null 值
    // 或
    if (isset($data[$key])) { ... } // 一般情況
} else {
    // 非陣列（false、null、物件、純量）
    // 視業務邏輯處理
}

實際場景範例

1. API 回應解析

<?php
$response = json_decode($json, true);
if (isset($response['data']['items'])) {
    foreach ($response['data']['items'] as $item) { ... }
}
// 任一層級不存在或為 null 直接跳過，無警告

2. 陣列鍵存在但值為 null 需區分

<?php
$data = ['key' => null];
var_dump(isset($data['key']));        // bool(false)
var_dump(array_key_exists('key', $data)); // bool(true)

// 此時需用 array_key_exists 確認「鍵已設定但值為 null」
if (array_key_exists('key', $data)) {
    // 鍵存在，處理 null 值邏輯
}

3. 物件屬性檢查

<?php
$obj = (object)['prop' => 'value'];
var_dump(isset($obj->prop)); // true
var_dump(property_exists($obj, 'prop')); // true (含不可見屬性)

// 動態屬性
var_dump(isset($obj->dynamic)); // false

總結

• **一般情況優先使用 isset()**：簡潔、安全、效能佳，涵蓋「變數存在且非 null」語意。
• **需區分「鍵存在但值為 null」時用 array_key_exists()**，但**必須先確認是陣列**（is_array()）。
• **PHP 8+ 可用 ?-> Nullsafe 運算子**鏈式安全存取嵌套結構。
• 避免直接對不確定類型的變數呼叫 array_key_exists，否則產生警告汙染日誌。