PHP array_key_exists(): Dizide Anahtar Var mı Kontrolü

array_key_exists('key', $array) dizide o anahtar varsa true, yoksa false döndürür. Sıraya dikkat edin: önce anahtar, sonra dizi gelir. Anahtar altında saklanan değer null olsa bile true döndürür; isset() fonksiyonunun yapmadığı tek şey budur.

<?php
$user = ['name' => 'Ada', 'email' => 'ada@example.com', 'phone' => null];

var_dump(array_key_exists('email', $user));
var_dump(array_key_exists('address', $user));
var_dump(array_key_exists('phone', $user));   // key is there, value is null

$list = ['a', 'b', 'c'];
var_dump(array_key_exists(2, $list));         // integer keys too

Bir anahtar yerine bir değeri kontrol etmek için in_array() kullanın.

array_key_exists ile isset karşılaştırması

İkisi de bir anahtarı kontrol eder. Yalnızca değer null olduğunda farklı sonuç verirler: isset() null bir değeri "ayarlanmamış" sayar, array_key_exists() ise dizide gerçekte ne olduğunu bildirir.

<?php
$form = ['name' => 'Ada', 'nickname' => null, 'age' => 0, 'bio' => ''];

foreach (['name', 'nickname', 'age', 'bio', 'missing'] as $key) {
    printf(
        "%-9s isset: %-5s  array_key_exists: %s\n",
        $key,
        var_export(isset($form[$key]), true),
        var_export(array_key_exists($key, $form), true)
    );
}

0 ve '' ikisi için de ayarlanmış sayılır; onları yalnızca null ayırır. Hangisini istediğiniz, verinizde null değerinin ne anlama geldiğine bağlıdır:

• null "değer yok" anlamına geldiğinde isset() kullanın. Yaygın durum budur; bir dil yapısıdır (biraz daha hızlıdır) ve iç içe yolları ve tanımsız değişkenleri uyarı vermeden kabul eder.
• null eksik bir anahtardan ayırt etmeniz gereken gerçek bir değer olduğunda array_key_exists() kullanın: null olarak gönderilmiş bir JSON alanı, NULL olan bir veritabanı sütunu, temizlemek için açıkça null yapılmış bir seçenek.

isset sayfası aynı anda birkaç değişkeni kontrol etmek dahil diğer kullanımlarını anlatır.

Bir JSON verisinde null ile eksiği ayırt etme

Yalnızca array_key_exists() fonksiyonunun doğru yanıtı verdiği tipik bir durum: bir kaydı JSON'dan güncelleyen bir API. null olarak gönderilen bir alan "temizle", hiç gönderilmeyen bir alan "dokunma" anlamına gelir. isset() ikisini aynı görür.

<?php
$record = ['name' => 'Ada', 'phone' => '555-0100', 'city' => 'London'];
$patch  = json_decode('{"phone": null, "city": "Paris"}', true);

foreach (['name', 'phone', 'city'] as $field) {
    if (array_key_exists($field, $patch)) {
        $record[$field] = $patch[$field];   // includes setting null
    }
}

var_dump($record);

isset($patch[$field]) ile telefon numarası kalırdı, çünkü null eksik bir alan gibi görünürdü.

key_exists() aynı fonksiyondur

key_exists(), PHP'nin ilk dönemlerinden kalma bir array_key_exists() takma adıdır. Aynı argümanlar, aynı sonuç. Okuyucuların görmeyi beklediği tam ismi tercih edin.

<?php
$config = ['debug' => false];

var_dump(key_exists('debug', $config));
var_dump(array_key_exists('debug', $config));
var_dump(key_exists('cache', $config));

Anahtar türleri: "1" ve 1 aynı anahtardır

Dizi anahtarları tam sayı veya dizgedir ve düz bir ondalık tam sayı olan dizge tam sayı olarak saklanır. Yani array_key_exists('1', $arr) 1 anahtarını bulur, tersi de geçerlidir. '01' gibi bir dizge dizge olarak kalır ve farklı bir anahtardır.

<?php
$byId = [1 => 'Ada', 2 => 'Linus', '07' => 'Grace'];

var_dump(array_key_exists('1', $byId));    // "1" is the int key 1
var_dump(array_key_exists(7, $byId));      // 7 is not "07"
var_dump(array_key_exists('07', $byId));

İç içe anahtarları ve birkaç anahtarı kontrol etme

array_key_exists() tek bir seviyeye bakar. null değerinin önemli olmadığı iç içe bir yol için isset($a['x']['y']) her seviyeyi tek seferde kontrol eder. Önemli olduğu bir yol için kısa bir yardımcı fonksiyon seviyeleri yürür. Birkaç anahtarın hepsinin var olduğunu kontrol etmek için array_diff_key() ile karşılaştırın.

<?php
function hasPath(array $data, array $path): bool
{
    foreach ($path as $key) {
        if (!is_array($data) || !array_key_exists($key, $data)) {
            return false;
        }
        $data = $data[$key];
    }
    return true;
}

$order = ['customer' => ['address' => ['city' => 'Lyon', 'zip' => null]]];

var_dump(isset($order['customer']['address']['zip']));          // null: false
var_dump(hasPath($order, ['customer', 'address', 'zip']));       // present: true
var_dump(hasPath($order, ['customer', 'phone']));

$required = ['name', 'email', 'password'];
$input = ['name' => 'Ada', 'email' => 'ada@example.com'];
$missing = array_keys(array_diff_key(array_flip($required), $input));
print_r($missing);

array_flip($required) isim listesini anahtarlara çevirir, böylece array_diff_key() onları girdinin anahtarlarıyla karşılaştırabilir; geriye kalan, bir hata mesajına hazır eksik alanlar listesidir.

Nesneler property_exists gerektirir

Eski PHP sürümleri array_key_exists() içinde bir nesne kabul ederdi. PHP 8 bunun yerine bir TypeError fırlatır. Nesneler için property_exists() tanımlı veya dinamik bir özelliği (null yapılmış olsa bile) kontrol eder; isset($obj->prop) ise dizilerdeki isset() gibi çalışır.

<?php
class User
{
    public ?string $phone = null;
    public string $name = 'Ada';
}

$u = new User();

var_dump(property_exists($u, 'phone'));   // declared, value null
var_dump(isset($u->phone));
var_dump(property_exists($u, 'email'));

$asArray = get_object_vars($u);
var_dump(array_key_exists('name', $asArray));

Son iki satır diğer yolu gösterir: get_object_vars() nesnenin erişilebilir özelliklerini bir diziye çevirir, ardından dizi fonksiyonları kullanılabilir.