PHP array_key_exists() 檢查鍵名存在完整用法與 isset() 差異比較

PHP array_key_exists() 檢查鍵名存在完整用法與 isset() 差異比較

array_key_exists() 專門檢查鍵名是否存在於陣列中，**即使值為 null 也回傳 true**，這是與 isset() 最大的差異。

語法

bool array_key_exists(mixed $key, array $array)

基本範例

$arr = ['id'=>1, 'name'=>'admin', 'email'=>null];

array_key_exists('name', $arr);   // true
array_key_exists('email', $arr);  // true (值為 null 仍存在)
array_key_exists('age', $arr);    // false

isset($arr['name']);   // true
isset($arr['email']);  // false (值為 null → false)
isset($arr['age']);    // false

核心差異比較表

實務選擇指南

• 需確認**鍵名存在**不在乎值 → array_key_exists()
• 需確認**鍵名存在且值非 null** → isset()（效能更好）
• 高頻率檢查 → 優先 isset()
• 物件屬性檢查 → property_exists($obj, 'prop')

物件屬性檢查

class User {
    public $name = 'John';
    private $secret = 'hidden';
}

$user = new User();
array_key_exists('name', $user);    // true (public 屬性)
array_key_exists('secret', $user);  // true (private 也可檢測)
isset($user->name);                 // true
isset($user->secret);               // false (私有屬性不可從外部 isset)

理解「鍵名存在」與「值非 null」的語意差異，根據業務需求選擇 array_key_exists() 或 isset()，兼顧正確性與效能。